{
  "$comment": "A2A Agent Card (Agent2Agent protocol). Declares AGENTS WELCOME as a discoverable agent/service other agents can delegate to. Distinct from /.well-known/agents.json, which is this site's full endpoint manifest.",
  "protocolVersion": "0.3",
  "name": "AGENTS WELCOME",
  "description": "A reference agent for the agentic web. Answers grounded questions from The Agentic Web Almanac (crawlers, protocols, models, terms), audits any URL for agent-readiness, and verifies AI-crawler identities. Built by Claude Fable 5.",
  "url": "https://agentswelcome.dev",
  "version": "1.3.0",
  "provider": {
    "organization": "AGENTS WELCOME (built by Claude Fable 5)",
    "url": "https://agentswelcome.dev/"
  },
  "documentationUrl": "https://agentswelcome.dev/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "skills": [
    {
      "id": "ask_almanac",
      "name": "Ask the Almanac",
      "description": "Answer a natural-language question about the agentic web, grounded strictly in the Almanac datasets with citations.",
      "tags": [
        "qa",
        "reference",
        "nlweb",
        "rag"
      ],
      "examples": [
        "How much does Claude Opus cost per million tokens?",
        "Is ClaudeBot allowed to ignore robots.txt?",
        "What is x402 and who created it?"
      ],
      "endpoint": "GET /api/ask?q={question}"
    },
    {
      "id": "audit_site",
      "name": "Agent-Readiness Audit",
      "description": "Score any URL on 18 agent-first signals across four dimensions — Discovery, Content, Capability and Trust — (llms.txt, markdown negotiation, AI-aware robots.txt, JSON-LD, agents.json…) and return concrete fixes.",
      "tags": [
        "audit",
        "seo",
        "agent-experience"
      ],
      "examples": [
        "Audit https://example.com for agent-readiness"
      ],
      "endpoint": "POST /api/audit {\"url\": \"...\"}"
    },
    {
      "id": "identify_user_agent",
      "name": "Identify a Crawler",
      "description": "Given a User-Agent, say which known AI crawler it claims to be and how to verify it for real.",
      "tags": [
        "crawlers",
        "identity",
        "security"
      ],
      "examples": [
        "Which bot is 'GPTBot/1.2'?"
      ],
      "endpoint": "GET /api/verify-crawler?ua={user-agent}"
    },
    {
      "id": "search_almanac",
      "name": "Search the Almanac",
      "description": "Keyword search across all five Almanac datasets.",
      "tags": [
        "search",
        "reference"
      ],
      "examples": [
        "search for mcp",
        "search for agentic commerce"
      ],
      "endpoint": "GET /api/search?q={query}"
    }
  ]
}