agent-ready

{
  "protocolVersion": "0.3.0",
  "name": "agent-ready",
  "description": "AI agent readability scanner. Scores any site against the Vercel Agent Readability Spec and llmstxt.org, and reports per-check remediation guidance.",
  "version": "1.0.0",
  "url": "https://agent-ready.dev/api/v1/a2a",
  "preferredTransport": "JSONRPC",
  "documentationUrl": "https://agent-ready.dev/docs/api",
  "provider": {
    "organization": "Agent Ready",
    "url": "https://agent-ready.dev"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "supportedInterfaces": [
    {
      "url": "https://agent-ready.dev/api/v1/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "0.3.0"
    }
  ],
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "description": "Agent Ready Pro API key (ar_live_\u2026). Required for scan_site and tasks/get; the ask skill is public. Issue a key at https://agent-ready.dev/dashboard/api-keys."
    }
  },
  "security": [
    {
      "bearer": []
    },
    {}
  ],
  "skills": [
    {
      "id": "scan_site",
      "name": "Scan a site",
      "description": "Run the agent-ready scanner against a URL. Returns Vercel score, llmstxt.org score, per-check results, and discovered agentic-protocol endpoints. Send via message/send; a long scan returns a working Task whose id you poll with tasks/get.",
      "tags": [
        "scan",
        "readability",
        "llms-txt",
        "mcp",
        "a2a"
      ],
      "examples": [
        "Scan https://example.com for AI agent readability."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_scan",
      "name": "Get a scan by id",
      "description": "Fetch a completed or in-progress scan by its id via the A2A tasks/get method. Only scans owned by the authenticated API key's user are returned.",
      "tags": [
        "scan",
        "read"
      ],
      "examples": [
        "Get the result of scan abc123 via tasks/get."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ask",
      "name": "Ask Agent Ready",
      "description": "Natural-language search (NLWeb) over Agent Ready's own methodology, check registry, and the specs it validates. Public \u2014 no API key required. Returns Schema.org-typed results.",
      "tags": [
        "ask",
        "nlweb",
        "search",
        "methodology"
      ],
      "examples": [
        "How is the llms.txt score calculated?"
      ],
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}