Agent Readiness Rules

What We Check

72 rules across 15 categories. Each rule ensures your site is discoverable, understandable, and usable by AI agents.

Quick fix Moderate Complex
🔍
Discovery
Can AI agents find your site and understand what it offers?
8 rules
🔍
Robots.txt File
Your site has a robots.txt file that tells crawlers and AI agents what they can access.
Quick fix
🗺️
Sitemap File
Your site has a sitemap listing all important pages for agents to discover.
Quick fix
🧭
Agent Guide
Your site has a dedicated guide that tells AI agents what you offer and how to interact.
Moderate
📄
LLMs.txt File
Your site has an llms.txt file that provides a plain-text overview for large language models.
Quick fix
🔗
Link Relationships
Your homepage includes link headers that connect related resources together.
Moderate
📚
API Catalog
Your site publishes a catalog of all available APIs in a standard location.
Moderate
🏷️
Content Signals
Your robots.txt declares preferences about how AI can use your content.
Quick fix
🌐
DNS Agent Discovery
Your domain has DNS records that help agents discover your services automatically.
Moderate
📖
Documentation
Is your API documented in formats that AI agents can read?
11 rules
📋
API Specification
Your site has a machine-readable API specification that agents can parse.
Complex
🧪
Agent Guide Schema Validation
Your agent guide follows the expected format with all required fields.
Moderate
🔌
MCP Server Descriptor
Your site advertises its MCP server so agents can discover and connect to it.
Moderate
📑
Detailed LLMs File
Your site has an extended llms-full.txt with comprehensive information for AI models.
Moderate
📌
LLMs File Linked from HTML
Your homepage links to your llms.txt file so AI models can find it.
Quick fix
📡
RSS or Atom Feed
Your site has an RSS or Atom feed for agents to subscribe to updates.
Moderate
🖼️
Social Preview Image
Your site has a social preview image that appears when shared on social media or in AI responses.
Quick fix
⭐
SVG Favicon
Your site has a scalable SVG favicon that looks crisp at any size.
Quick fix
🔗
Canonical URL
Your pages have canonical URLs that tell agents which version is the official one.
Quick fix
📰
RSS Feed Linked from HTML
Your homepage links to your RSS feed so agents can discover it.
Quick fix
📝
Agent Registration Instructions
Your site has instructions telling agents how to register and authenticate.
Moderate
⚡
Actionability
Can agents actually call your API with the right authentication?
3 rules
🔄
Guide and API Consistency
Your agent guide and your API specification describe the same endpoints.
Moderate
🔑
Authentication Declared
Your site declares its authentication method in a machine-readable way.
Moderate
🧩
Capability Coverage
Your agent guide covers all the capabilities your service offers.
Moderate
🤖
Machine-Readable
Is your site's data structured for AI consumption?
6 rules
💲
Machine-Readable Pricing
Your pricing information is available in a format agents can parse automatically.
Moderate
⏱️
Rate Limits Declared
Your site declares its rate limits in a machine-readable format.
Moderate
⚠️
Structured Error Responses
Your API returns errors in a consistent, machine-readable format.
Moderate
🛠️
MCP Tools List
Your MCP server responds to tool listing requests.
Moderate
📞
MCP Tool Calls
Your MCP server responds when agents try to call a tool.
Moderate
📡
MCP Streaming Support
Your MCP server supports streaming connections for real-time communication.
Complex
✅
Verification
Can agents verify you are who you say you are?
1 rule
✅
Owner Verification
Your site can prove that you own the domain and are who you claim to be.
Complex
🔄
Content Negotiation
Does your site serve the right format to AI agents?
7 rules
🤖
Agent User-Agent Format
Your site serves appropriate content when an AI agent visits.
Moderate
📊
JSON Format Support
Your site returns JSON when an agent requests it.
Moderate
📝
Plain Text Format Support
Your site returns plain text when an agent requests it.
Quick fix
⬇️
Markdown Format Support
Your site returns Markdown when an agent requests it.
Quick fix
🎯
Preferred Format Selection
Your site respects format preferences when agents specify what they want.
Moderate
🔀
Vary Header
Your site tells caches that content varies based on the requested format.
Quick fix
📍
No Redirect on Negotiation
Your site serves the requested format directly without redirecting.
Quick fix
💰
Payments
Can agents pay for your services programmatically?
9 rules
💰
Paid Endpoint Response
When an agent tries to access a paid feature, your site responds with a clear payment request.
Complex
🔓
Payment Challenge Decodable
The payment request your site sends is properly formatted and can be decoded by agents.
Complex
📋
Payment Required Header
Your payment responses include a header that tells agents payment is needed.
Moderate
👤
Payment Recipient
Your payment requests specify who should receive the payment.
Moderate
💵
Payment Amount
Your payment requests specify how much the agent needs to pay.
Moderate
📄
Payment Discovery File
Your site publishes a file that describes all payment options in one place.
Moderate
🏦
Payment Facilitator
Your payment requests specify a facilitator that can process the payment.
Complex
⚡
Lightning Payment Support
Your site supports Lightning Network payments for instant, low-cost transactions.
Complex
🎫
Lightning Payment Details
Your Lightning payment responses include all required details for agents to pay.
Complex
🏪
Bazaar
Is your agent listed in the decentralized marketplace?
3 rules
🏪
Bazaar Discoverable
Your agent marketplace listings can be discovered by other agents.
Moderate
🏷️
Bazaar Service Declared
Your site declares what services it offers in the Bazaar marketplace.
Moderate
🛒
Bazaar in Lightning Payments
Your Lightning payment responses include Bazaar marketplace information.
Complex
📋
OpenAPI
Is your API specification complete and reachable?
6 rules
📋
API Spec at Standard Location
Your API specification is published at the standard location agents expect.
Quick fix
🛤️
API Paths Defined
Your API specification lists all available paths and endpoints.
Complex
🌐
API Paths Reachable
All endpoints defined in your API spec actually work when agents call them.
Moderate
🔍
Response Matches Spec
Your API responses match what your specification promises.
Moderate
🔢
API Version Identified
Your API specification clearly states which version it is.
Quick fix
🏷️
API Title
Your API specification has a clear title that describes your service.
Quick fix
🎯
Skills
Can agents discover and use your specialized skills?
3 rules
🎯
Skill File Present
Your site has a skill file that describes specialized capabilities agents can use.
Moderate
✓
Skill File Format Valid
Your skill file follows the expected format with proper metadata.
Quick fix
📚
Skills Index
Your site has an index listing all available skills in one place.
Moderate
📜
Agents.txt
Do you have instructions specifically for AI agents?
1 rule
📜
Agents.txt File
Your site has an agents.txt file with instructions specifically for AI agents.
Moderate
🌐
WebMCP
Can browsers interact with your agent via MCP?
3 rules
🌐
WebMCP Manifest
Your site has a WebMCP manifest that enables browser-based agent interactions.
Complex
📝
WebMCP Form Annotations
Your forms are annotated so WebMCP agents can fill them automatically.
Moderate
🖥️
WebMCP Browser Tools
Your site exposes browser-side tools that agents can call through WebMCP.
Complex
🪪
Identity
Can agents verify your on-chain identity?
2 rules
🪪
WebFinger Identity Lookup
Your site can answer 'who is this?' queries from AI agents.
Moderate
🆔
DID Document
Your site provides a Decentralized Identifier document for on-chain identity verification.
Complex
🔐
Bot Authentication
Can you prove which AI bot is making the request?
6 rules
🔐
MCP Auth Discovery
Your MCP server's authentication info is discoverable by agents.
Moderate
✍️
Bot Signatures Directory
Your site has a directory of bot signatures for verifying AI agent identities.
Complex
👥
Bot Directory Members
Your bot signatures directory has valid, recognized members.
Moderate
🔑
Bot Public Keys
Public keys for verified bots are reachable and valid.
Moderate
🛡️
Protected Resource Metadata
Your site publishes metadata about what resources are protected and how.
Moderate
📜
Web Bot Auth Directory
Your site has a directory for web-based bot authentication using HTTP message signatures.
Complex
🏗️
Infrastructure
Are your caching, errors, and rate limits agent-ready?
3 rules
⚡
Cache Headers
Your site sends cache headers so agents and CDNs know how to cache your content.
Quick fix
🚫
Structured 404 Errors
Your site returns structured JSON for 404 errors instead of plain HTML.
Quick fix
⏱️
Rate Limit Headers
Your site sends rate limit headers so agents know how many requests they can make.
Quick fix

Want to check your site against all 72 rules?

Scan Your Site