# 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)
     Each failing check includes a "hint" field with fix instructions.
     Each score group includes "kbSlug" pointing to a knowledge base article.
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 — full report with historical comparison and delta
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

Payment gating for premium endpoints is planned but not currently active.

## Badge

Add an agentgrade badge to your README or landing page:

Badge image URL: https://asiangrade.com/api/badge?url=https://YOURDOMAIN.COM
Report link URL: https://asiangrade.com/s/YOURDOMAIN.COM

Markdown:
[![agentgrade](https://asiangrade.com/api/badge?url=https://YOURDOMAIN.COM)](https://asiangrade.com/s/YOURDOMAIN.COM)

HTML:
<a href="https://asiangrade.com/s/YOURDOMAIN.COM"><img src="https://asiangrade.com/api/badge?url=https://YOURDOMAIN.COM" alt="agentgrade badge"></a>

Replace YOURDOMAIN.COM with your actual domain. The report URL uses /s/ (not /report/).

## Example

curl "https://asiangrade.com/api/scan?url=https://agent.news"

## Knowledge Base

- [Getting Started — Make Your Site Agent-Ready](https://asiangrade.com/kb/getting-started): Quick checklist to make your site discoverable and usable by AI agents.
- [Understanding Your Score](https://asiangrade.com/kb/understanding-your-score): How agentgrade scores your site, what verified vs declared means, and how to improve.
- [Cloudflare & Agent Access](https://asiangrade.com/kb/cloudflare-agent-access): Why Cloudflare blocks agent traffic and how to configure it for agent accessibility.
- [Comparing Payment Protocols](https://asiangrade.com/kb/comparing-payment-protocols): x402 vs MPP vs L402 — when to use each machine payment protocol.
- [About Scanning](https://asiangrade.com/kb/about-scanning): How agentgrade scans sites, what data it collects, and how to opt out.
- [x402 — HTTP Payment Protocol](https://asiangrade.com/kb/x402): The HTTP 402 payment protocol that lets agents pay per-request with USDC on Base.
- [MPP — Machine Payment Protocol](https://asiangrade.com/kb/mpp): Micropayment protocol using pathUSD on the Tempo network for sub-second agent payments.
- [How AI Agents Actually Browse the Web](https://asiangrade.com/kb/how-ai-agents-browse): How ChatGPT, Perplexity, and Gemini retrieve and process web content — and what it means for your site.
- [SPT — Stripe Shared Payment Tokens](https://asiangrade.com/kb/spt): Stripe card payments for AI agents via Shared Payment Tokens and the MPP 402 flow.
- [L402 — Lightning Payments](https://asiangrade.com/kb/l402): Bitcoin Lightning Network payments for API access using macaroons and invoices.
- [MCP — Model Context Protocol](https://asiangrade.com/kb/mcp): JSON-RPC 2.0 protocol that lets AI models call your tools directly.
- [x-payment-info — OpenAPI Payment Discovery](https://asiangrade.com/kb/x-payment-info): Pre-request payment discovery via OpenAPI extensions so agents know pricing before triggering a 402.
- [OpenAPI — API Specification](https://asiangrade.com/kb/openapi): Machine-readable API description that tells agents what endpoints exist and how to call them.
- [Bazaar — Service Discovery](https://asiangrade.com/kb/bazaar): The x402 service catalog that lets agents discover and browse paid API endpoints.
- [llms.txt — LLM Context File](https://asiangrade.com/kb/llms-txt): Plain-text file that explains your service to large language models.
- [agents.txt — Agent Access Policies](https://asiangrade.com/kb/agents-txt): Defines what AI agents are allowed to do on your service.
- [AI Plugin Manifest](https://asiangrade.com/kb/ai-plugin): Plugin manifest that helps AI assistants discover and integrate with your service.
- [robots.txt for Agents](https://asiangrade.com/kb/robots-txt): Agent-specific directives in robots.txt that signal your site welcomes AI crawlers.
- [Identity Protocols](https://asiangrade.com/kb/identity): Decentralized identity standards that let agents verify who owns a domain.
- [Claude Plugin Manifest](https://asiangrade.com/kb/claude-plugin): Plugin manifest that lets Claude and other Anthropic tools discover your service.
- [Skill file (SKILL.md)](https://asiangrade.com/kb/skills): A markdown file with YAML frontmatter that tells agents how to use your service.
- [Content Negotiation for AI Agents](https://asiangrade.com/kb/content-negotiation): How to serve agent-optimized responses based on User-Agent and Accept headers.
- [Web Bot Auth (RFC 9421)](https://asiangrade.com/kb/web-bot-auth): How AI agents prove their identity with cryptographic HTTP message signatures.
- [A2A — Agent-to-Agent Protocol](https://asiangrade.com/kb/a2a): Google's protocol for AI agents to discover and communicate with other agents.
- [WebMCP — Browser Agent Interaction](https://asiangrade.com/kb/webmcp): A W3C draft protocol that lets browser-based AI agents interact with websites through annotated forms.