agentgrade

# agentgrade > Scan any site for agent capabilities and payment protocols. agentgrade produces Lighthouse-like reports for agentic services. Point it at any URL and it checks for: - x402 / MPP / L402 payment protocols (HTTP 402 headers) - Well-known discovery endpoints (/.well-known/x402.json, mpp.json, etc.) - Bazaar service catalogs (discoverable agentic endpoints) - MCP (Model Context Protocol) endpoints - Claude and AI plugin manifests - OpenAPI specs, llms.txt, agents.txt, skills manifests - Identity protocols (WebFinger, DID, Nostr, AT Protocol) ## API GET /api/scan?url=https://example.com — full JSON scan results (synchronous) POST /api/scan {url} — queue async scan, returns job ID (requires database) GET /api/scan/:id — poll async scan job status and result GET /api/v1/scan?url=https://example.com — compact M2M scan (flat JSON, score) GET /api/badge?url=https://example.com — SVG badge for embedding GET /api/report?url=https://example.com — premium report with delta (x402 or MPP payment) GET /api/history?url=https://example.com — past scan summaries (requires database) GET /mcp — MCP tool manifest POST /mcp — JSON-RPC 2.0 tool calls (scan_url, scan_compact, get_history, validate_x402_json) GET /health — health check GET /openapi.json — OpenAPI 3.0 spec ## Payment agentgrade accepts x402 (Base/USDC) and MPP (Tempo/pathUSD) for premium endpoints. Set X-Idempotency-Key header to prevent double-charges on retries. ## Badge Add an agentgrade badge to your README or landing page: Badge image URL: https://agentgrade.com/api/badge?url=https://YOURDOMAIN.COM Report link URL: https://agentgrade.com/s/YOURDOMAIN.COM Markdown: [](https://agentgrade.com/s/YOURDOMAIN.COM) HTML: <a href="https://agentgrade.com/s/YOURDOMAIN.COM"><img src="https://agentgrade.com/api/badge?url=https://YOURDOMAIN.COM" alt="agentgrade badge"></a> Replace YOURDOMAIN.COM with your

{"openapi":"3.0.3","info":{"title":"agentgrade","description":"Scan any site for agent capabilities and payment protocols. Produces Lighthouse-like reports for agentic services.","version":"1.0.0"},"servers":[{"url":"https://agentgrade.com"}],"paths":{"/api/scan":{"get":{"operationId":"scanUrl","summary":"Scan a URL for agent capabilities and payment protocols","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","format":"uri"},"description":"The URL to scan (must