---
name: agent-readiness-scan
description: Scan a URL for agent readiness — payment protocols (x402, MPP, L402, SPT), discovery files, MCP, OpenAPI, and more. Returns a 0-100 score and per-check evidence.
---

# Agent Readiness Scan

Use these endpoints to scan a URL with agentgrade:

## Scan a URL

`GET /api/scan?url={url}` — full report (HTML-friendly response).
`GET /api/v1/scan?url={url}` — compact M2M response: flat `{ url, origin, rails, capabilities, bazaarServices, score, ts }`.

## Get a badge

`GET /api/badge?url={url}` — returns an SVG badge with the score.

## History

`GET /api/history?url={url}` — past scans for the same URL.

## MCP

`POST /mcp` — JSON-RPC 2.0 endpoint with tools: `scan`, `history`, `badge`.

All endpoints are free and return JSON unless noted.