Agent Surface
Reference Links

Reference Links

Canonical standards, docs, specs, and source links for agent-readable software surfaces.

This is the single source index for standards, specs, and official docs that Agent Surface tracks. Use it when you want the primary source rather than the curated tooling view.

Agent-Readable Web

ReferenceWhat It CoversUse It For
Cloudflare Agent ReadinessDiscoverability, content accessibility, bot access control, and capabilitiesUnderstanding what agent-readiness scanners currently check.
Agent Readiness CheckerPublic site scanner for agent readinessSpot-checking whether a URL exposes agent-readable signals.
Markdown for AgentsAccept: text/markdown, x-markdown-tokens, Content-Signal, and edge HTML-to-Markdown conversionServing readable pages to agents without wasting context on HTML.
llms.txtLLM-readable site indexesPublishing a concise map of docs, APIs, and key resources.
Content SignalsSearch, AI input, and AI training policy signalsDeclaring how accessed content may be used.
Web Bot AuthSigned HTTP requests for bot identityLetting sites distinguish accountable agents from anonymous automation.
API Catalog RFC 9727/.well-known/api-catalogAdvertising API specs, docs, status pages, and related API metadata.

Agent Skills And Context

ReferenceWhat It CoversUse It For
Agent SkillsOpen format for reusable folders of instructions, scripts, references, and assetsPackaging repeatable agent capabilities without bloating the base prompt.
Agent Skills SpecificationSKILL.md frontmatter, directories, validation, and progressive disclosureAuthoring skills that portable agents can discover and load.
Adding Skills SupportSkill discovery, catalogs, activation, and context managementImplementing a skills-compatible agent runtime or client.
Agent Skills Reference LibraryValidation and prompt XML generation toolingValidating local or published skills.
AGENTS.mdRepository instructions for coding agentsGiving agents repo-level commands, boundaries, conventions, and navigation.

MCP

ReferenceWhat It CoversUse It For
MCP IntroductionMCP as the standard connector between AI apps and external systemsGrounding protocol decisions.
MCP ArchitectureClients, servers, hosts, and capability flowDesigning where MCP belongs in an agent system.
Build an MCP ServerServer implementation basicsExposing tools, resources, and prompts to agents.
Connect to Remote MCP ServersRemote server connection modelPublishing MCP over network transport.
MCP InspectorInteractive server inspection and debuggingTesting tool definitions, schemas, prompts, and resources.
MCP RegistryPublic MCP server discoveryFinding and distributing MCP servers.

Auth And Identity

ReferenceWhat It CoversUse It For
OAuth Protected Resource Metadata RFC 9728/.well-known/oauth-protected-resourceLetting agents discover authorization servers and resource metadata.
OAuth 2.1 DraftModern OAuth profileDesigning delegated machine-to-machine auth.
DPoP RFC 9449Proof-of-possession access tokensReducing bearer-token replay risk for sensitive tools.

Agent Runtimes And Tooling Docs

ReferenceWhat It CoversUse It For
Mastra DocsTypeScript agents, tools, workflows, memory, RAG, MCP, evals, and voiceDefault local TypeScript agent scaffolding.
Vercel AI SDKModel calls, tools, structured output, streaming, and UITypeScript AI app foundations.
OpenAI Agents SDKAgents, tools, handoffs, guardrails, tracing, and evalsOpenAI-native agent systems.
OpenRouter DocsModel routing, structured outputs, plugins, and hosted toolsProvider optionality and first-party model-call tools.
Cloudflare AgentsDurable Object-backed agents, state, scheduling, tools, MCP, and browser accessWorkers-native agent systems.
Cloudflare AI GatewayGateway observability, caching, rate limits, guardrails, retries, and routingGoverned model access across providers.
Cloudflare Browser RunManaged browser automation, screenshots, PDFs, Markdown extraction, crawling, Playwright, and MCPBrowser access for agents.
Cloudflare SandboxIsolated code execution for agents and applicationsRunning untrusted or generated code outside the app process.

Commerce And Payments

ReferenceWhat It CoversUse It For
x402HTTP-native machine paymentsPay-to-access resources and APIs.
Universal Commerce ProtocolCommerce discovery and transaction protocolAgent-driven ecommerce surfaces.
Agentic Commerce ProtocolAgent-mediated purchasing flowsAgent-initiated buying with explicit payment boundaries.

How This Page Relates To The Catalog

Use this page for canonical sources and specs. Use the Tooling Catalog for curated recommendations, tiers, and judgement calls.

On this page