agents.txt Reference Agent

{
  "name": "agents.txt Reference Agent",
  "description": "A reference A2A agent demonstrating the AgentCard discovery path declared by the agents.txt standard. Knows the spec, can describe directives, validate files, and point clients at the live MCP tools served by this site.",
  "url": "https://agents-txt.com/a2a",
  "version": "1.0.0",
  "documentationUrl": "https://agents-txt.com/spec",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.2",
        "description": "Supports payments using the x402 protocol for on-chain settlement. Mirrors the x402 declaration in this site's agents.txt and agents.json.",
        "required": false
      },
      {
        "uri": "https://github.com/google-agentic-commerce/AP2",
        "description": "Supports the Agent Payments Protocol (AP2) mandate layer (CheckoutMandate, PaymentMandate) for non-repudiable agent-initiated payments. Mirrors the ap2 declaration in this site's agents.txt and agents.json.",
        "required": false
      }
    ]
  },
  "authentication": {
    "schemes": [
      "none"
    ]
  },
  "defaultInputModes": [
    "text",
    "text/plain"
  ],
  "defaultOutputModes": [
    "text",
    "text/plain"
  ],
  "skills": [
    {
      "id": "explain_directive",
      "name": "Explain an agents.txt directive",
      "description": "Returns the spec section text for a named directive (Protocols, Authorization, MCP, Skills, A2A, etc.) plus an example and the relevant section number.",
      "inputModes": [
        "text",
        "text/plain"
      ],
      "outputModes": [
        "text",
        "text/plain"
      ],
      "tags": [
        "spec",
        "agents.txt",
        "documentation"
      ],
      "examples": [
        "What does the Protocols: directive mean?",
        "Show me the spec for the A2A block.",
        "Where is Identity: required defined?"
      ]
    },
    {
      "id": "validate_agents_files",
      "name": "Validate agents.txt and agents.json",
      "description": "Runs the spec validators against a site's discovery files and returns a compliance report. Delegates to the audit_site MCP tool exposed at mcp.agents-txt.com.",
      "inputModes": [
        "text",
        "text/plain"
      ],
      "outputModes": [
        "text",
        "text/plain",
        "application/json"
      ],
      "tags": [
        "validation",
        "audit",
        "compliance"
      ],
      "examples": [
        "Validate https://example.com/agents.txt",
        "Audit example.com for agents.txt spec compliance"
      ]
    },
    {
      "id": "explain_payment_protocol",
      "name": "Explain an announced payment protocol",
      "description": "Returns a plain-language explanation of any payment protocol the site declares (x402, mpp, ap2): what it is, what role it plays, where the runtime details live, and how it composes with the others.",
      "inputModes": [
        "text",
        "text/plain"
      ],
      "outputModes": [
        "text",
        "text/plain"
      ],
      "tags": [
        "payments",
        "x402",
        "mpp",
        "ap2",
        "documentation"
      ],
      "examples": [
        "What does ap2 mean in this site's agents.txt?",
        "How does AP2 compose with x402?",
        "Explain MPP versus x402."
      ]
    },
    {
      "id": "summarize_capabilities",
      "name": "Summarize a site's agent capabilities",
      "description": "Reads agents.txt and agents.json from a target origin, summarizes the declared payment protocols, authorization scheme, MCP endpoints, skill packages, and A2A AgentCards in plain language.",
      "inputModes": [
        "text",
        "text/plain"
      ],
      "outputModes": [
        "text",
        "text/plain"
      ],
      "tags": [
        "discovery",
        "capabilities",
        "summary"
      ],
      "examples": [
        "What can an agent do on agents-txt.com?",
        "List the capabilities declared at example.com"
      ]
    }
  ],
  "protocolVersion": "0.2"
}