Methodology
Four layers, normalized to a 0–100 score. Checks that don't apply to a product are dropped from the denominator — you're only measured on what you could have. Emerging checks are displayed but never scored; bonus checks can only raise a score.
contract v1.0.0
Discovery
weight 20 · Can agents find and recommend you?- Sitemap present & freshrequired4 pts
Resolved the sitemap from robots.txt or /sitemap.xml, validated XML, and checked lastmod freshness
- Brand search discoverabilityrequired4 pts
Ran clean brand-name web searches and checked whether your domain is cited in the results
- Developer resource discoverabilityrecommended3 pts
Searched for your brand with developer-keyword suffixes and checked which official resources are cited
- Homepage states what you arerequired3 pts
An LLM read your homepage as an agent would and rated how confidently it could say what you do
- OpenGraph / social metadatarecommended2 pts
Parsed homepage og:title / og:description / og:image and twitter:card meta tags
- MCP registry listingsrecommended4 pts
Queried the official MCP registry, Smithery, Glama, and PulseMCP for servers matching your domain
- Agent skill publishedbonusemerging1 pts
Checked /skill.md, /.well-known/skills/, and skills.sh for published agent skills
- NLWeb endpointemerging1 pts
Probed /.well-known/nlweb.json and the /ask endpoint
Access
weight 30 · Can agents access your content and understand you?- robots.txt present & parseablerequired2 pts
Fetched /robots.txt and validated it parses as a robots policy
- AI crawler policyrequired5 pts
Evaluated robots.txt groups for the major AI agent user-agents (GPTBot, ClaudeBot, PerplexityBot, …)
- Content Signals directivesemerging2 pts
Looked for Content-Signal lines in robots.txt
- llms.txtrecommended4 pts
Fetched /llms.txt and validated it against the llmstxt.org shape (H1, summary, curated links)
- llms-full.txtbonusrecommended2 pts
Fetched /llms-full.txt and checked for substantial inline markdown content
- JSON-LD structured datarequired4 pts
Extracted and validated application/ld+json blocks on the homepage and pricing page
- Semantic HTML structurerequired3 pts
Scored landmark elements, heading hierarchy, and text-to-markup ratio on the homepage
- Markdown content negotiationrecommended3 pts
Requested key pages with Accept: text/markdown and probed .md twin URLs
- Agent user-agent paritybetarequired4 pts
Compared responses served to browser and AI-agent user-agents (informational while in beta)
- TLS & redirect hygienerequired2 pts
Checked http→https redirect behavior, chain length, and TLS health
- Response speed & weightrequired1 pts
Measured homepage TTFB, payload size, and compression
- Content readable without JavaScriptrequired2 pts
Measured visible text in the raw, unrendered homepage HTML
Usability
weight 40 · Can agents integrate with and use you?- OpenAPI spec discoverablerequired5 pts
Probed standard OpenAPI locations and docs links for a fetchable, parseable spec
- OpenAPI validity & qualityrecommended3 pts
Linted the spec: descriptions, operationIds, securitySchemes, servers
- Docs discoverablerequired4 pts
Followed homepage nav/footer links and probed /docs, /developers, docs.{domain}
- Docs qualityrecommended3 pts
An LLM rated your docs for clarity, completeness, runnable examples, and agent-friendliness
- Quickstart / getting startedrecommended2 pts
Looked for a quickstart/getting-started guide containing code blocks
- MCP server discoveryrequired5 pts
Probed /.well-known/mcp/server-card.json, mcp.json, and docs mentions for an MCP endpoint
- MCP handshake & tools listrequired4 pts
Performed a streamable-HTTP initialize + tools/list against the MCP endpoint
- MCP tool qualityrecommended3 pts
Linted listed tools for descriptions, typed input schemas, and naming
- npm SDKrecommended2 pts
Searched the npm registry for an official, domain-verified SDK package
- PyPI SDKrecommended2 pts
Searched PyPI for an official, domain-verified SDK package
- OAuth authorization server metadatarecommended3 pts
Fetched /.well-known/oauth-authorization-server (and openid-configuration fallback)
- OAuth protected resource metadatarecommended2 pts
Fetched /.well-known/oauth-protected-resource
- Auth documentationrecommended2 pts
Looked for /auth.md or an authentication docs page with code examples
- agents.mdrecommended3 pts
Fetched /agents.md and checked for substantive agent guidance
- security.txtrecommended1 pts
Fetched /.well-known/security.txt and validated Contact + Expires
- Accessibility basicsrequired2 pts
Static checks: lang attribute, title, alt coverage, labeled inputs, landmarks
- Agent configs in public repobonusemerging1 pts
Checked your public GitHub org's main repos for AGENTS.md / .claude / .cursor configs
- WebMCPemerging1 pts
Looked for WebMCP script declarations on the homepage
Payments
weight 10 · Can agents transact with you?- Pricing discoverablerequired5 pts
Followed nav/footer links and probed /pricing for a page with legible price signals
- Machine-readable pricingrecommended5 pts
Looked for Offer JSON-LD, then had an LLM attempt structured extraction of your plans
- x402 payment supportbonusrecommended2 pts
Probed /.well-known/x402 and API endpoints for HTTP 402 payment-required envelopes
- AP2 readinessemerging1 pts
Scanned fetched artifacts and well-known paths for AP2 hints
- Agentic Commerce Protocolemerging1 pts
Scanned docs and specs for agentic checkout endpoints
- Other agent payment protocolsbonusemerging1 pts
Scanned fetched artifacts for UCP/MPP protocol hints