agentic‑readiness docs
/
Build one › Run a scan ›

DocsCapabilitiesMCP server card

MCP server card

Advertises a Model Context Protocol endpoint agents can call.

adoption Early pilotstrend ▲ risingchecked once per sitechecks 9verified 2026-08-26
Build your MCP server card today A valid /.well-known/mcp.json pointing agents at your MCP server, with the transport it actually speaks.
Free Build your MCP server card

Why an agent cares

A card is how an agent finds the site's MCP endpoint without being told about it. The card format is still a draft extension and it explicitly rejects hosting under /.well-known/, so a card found at the paths we probe is real adoption at a non-standard path.

Adoption

Early pilots. Named early adopters exist, behind flags or trials. Nothing has been independently measured yet. For this one in particular, the protocol itself is everywhere; the discovery card we read for it is not.

Direction of travel: ▲ rising, as at .

The protocol is in production at GitHub, Stripe, Atlassian, Linear, Sentry and PayPal, but the card itself is a draft SEP with no published measurement of deployment.

AdopterDepthEvidence
Cloudflare (remote MCP hosting)productionblog.cloudflare.com
GitHub, Stripe, Linear, Sentry, Asanaproductionhidekazu-konishi.com
Atlassian (remote server GA)productiongithub.com

What we check

Absence is never a finding. Every check below runs only once mcpServerPresent is true, so a site that has not adopted this is not assessed on it and appears in no report. 9 of these 13 can fail it. In a Lumar crawl these land on one row per site, in the crawl-level table where itemType is mcp_server.
CheckSeverityRaisesOn whose authority
mcpServerInvalidJsonhighusabilityLumar readiness profile
mcpServerMissingUrlhighusabilityLumar readiness profile
mcpServerEndpointNotMcphighusabilityspecification (MCP transports 2025-06-18 (Streamable HTTP))
mcpServerEndpointUnavailablehighusabilityLumar readiness profile
mcpServerToolMissingNamehighconformance, usabilityspecification (MCP schema 2025-06-18 / 2025-11-25 / 2026-07-28 (Tool))
mcpServerToolMissingInputSchemahighconformance, usabilityspecification (MCP schema 2025-06-18 / 2025-11-25 / 2026-07-28 (Tool))
mcpServerDuplicateToolNamehighusabilityspecification (MCP 2026-07-28 server/tools (Tool Names))
mcpServerToolMissingDescriptionmediumusabilityLumar readiness profile
mcpServerUnknownMethodAcceptedmediumusabilityspecification (JSON-RPC 2.0 §5.1 (Error object), as MCP's wire format)
mcpServerNonstandardToolNameinformationalnothingspecification (MCP 2026-07-28 server/tools (Tool Names))
mcpServerStaleEndpointinformationalnothingLumar readiness profile
mcpServerMissingTransportinformationalnothingLumar readiness profile
mcpServerPartiallyAssessedcoverage notenothingour own coverage

Examples

Both of these are fixtures the test suite runs through the real collector, not snippets written for a document: the first is a shape we score as valid, the second is one we flag.

correctjsontest/e2e/test-pages/capabilities/correct.mcp-server-card.json
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server.schema.json",
  "name": "io.github.example/catalog-mcp",
  "description": "Catalog search and account operations for agents.",
  "version": "1.0.0",
  "remotes": [{ "type": "streamable-http", "url": "https://example.com/mcp" }]
}
present but wrongjsontest/e2e/test-pages/capabilities/issues.mcp-server-card.json
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server.schema.json",
  "name": "io.github.example/broken-mcp",
  "description": "Present but not connectable: the remote endpoint isn't an absolute http(s) URL.",
  "version": "1.0.0",
  "remotes": [{ "type": "streamable-http", "url": "example.com/mcp" }]
}

Specifications

Last re-read against the published documents: .

On pinning it. The card format is a draft extension that reserves the card at <mcp-url>/server-card and explicitly rejects hosting it under /.well-known/, so a card at either path we probe is adoption at a non-standard path rather than conformance. Secondary claims that the SEP was ratified in Nov 2025 do not survive the document, which reads Status: Draft, Created: 2026-01-21.