agentgrade.com

# AgentGrade > Lighthouse for AI agents. Scan any URL for a 0–100 agent-readiness score covering payment protocols, discovery files, MCP endpoints, OpenAPI, identity, and infrastructure. ## For AI agents If you are an agent helping a user improve their site's agent-readiness, follow these steps. 1. Scan the site: ```bash curl "https://agentgrade.com/api/scan?url=https://example.com" ``` The response is JSON with the shape: ```json { "score": { "pct": 0..100, "grade": "A".."F", "groups": [ ... ] }, "summary": "one-paragraph natural-language summary", "domain": "example.com", "checks": [ ... ] } ``` 2. Interpret the score: - score.pct is the percentage of weighted checks passed. - score.grade is the letter grade (A 90+, B 80+, C 70+, D 60+, F <60). - score.groups[] groups checks by topic (Discovery, Payment, Identity, etc.). - Each group has a kbSlug field pointing to the knowledge base article that explains it. 3. File remediation. For each failing check (passed: false): - Read the check.hint field — it contains the exact fix instructions. - Fetch the linked KB article for protocol details: curl "https://agentgrade.com/kb/<group.kbSlug>" - Apply the smallest change that turns the check green, then rescan. 4. Prefer the compact endpoint for batch work: ```bash curl "https://agentgrade.com/api/v1/scan?url=https://example.com" ``` Returns flat JSON with score, grade, and passed-check count only. Faster, cheaper to parse. 5. For MCP-based tool use, call https://agentgrade.com/mcp with JSON-RPC 2.0. Available tools: - scan_url — full scan (same shape as GET /api/scan) - scan_compact — flat JSON, score-only - get_history — past scans for a domain - validate_x402_json — validate a /.well-known/x402.json document ## What AgentGrade checks - x402, MPP, L402, SPT payment protocols (HTTP 402 headers, well-known endpoints, live probes) - Bazaar service catalogs (discoverable agentic endpoints) - MC

{"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