mlava/agent-ready-api

Use the Agent Ready REST API to scan any public URL for AI agent-readability against the Vercel Agent Readability Spec, the llmstxt.org standard, and agent-protocol manifests (MCP server cards, A2A, agents.json, agent-permissions.json, UCP, x402, NLWeb). Activates for "scan this site for AI agent-readability", "run an Agent Ready scan on {URL}", "check the Agent Ready score for {URL}", "what's the agent-readability rating for {URL}", or any time the user wants a programmatic readability scan via HTTP. Picks this skill when the user does NOT have the Agent Ready MCP server installed — for MCP, use the `agent-ready-mcp` skill instead.

Quality

90%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Agent Ready REST API — reference

Name: mlava/agent-ready-api
Rating: 72 (1 reviews)
Author: mlava

Occasional-lookup material. The day-to-day workflow, rate limits, and error recovery live in SKILL.md.

Endpoints

Method	Path	Auth	Purpose
`POST`	`/api/v1/scans`	Bearer	Start a new scan
`GET`	`/api/v1/scans/{id}`	Bearer	Get scan status / result
`GET`	`/api/v1/scans`	Bearer	List past scans (most-recent first)
`POST`	`/api/v1/ask`	none	Search Agent Ready docs (NLWeb)
`POST`	`/api/v1/mcp`	Bearer	MCP streamable-http endpoint (use `agent-ready-mcp` skill instead)

Discovery and reference URLs

API quickstart: https://agent-ready.dev/quickstart
API docs: https://agent-ready.dev/docs/api
OpenAPI 3.1 spec: https://agent-ready.dev/api/v1/openapi.json
Auth walkthrough (WorkOS auth.md aligned): https://agent-ready.dev/auth
Dashboard (issue keys): https://agent-ready.dev/dashboard/api-keys
Pricing: https://agent-ready.dev/pricing
Methodology (~70 checks): https://agent-ready.dev/methodology
Discovery hints: https://agent-ready.dev/.well-known/oauth-protected-resource, https://agent-ready.dev/.well-known/mcp/server-card.json

.tessl-plugin