Agent Readiness
Score your public API surface against the Agent Readiness framework — a neutral, evidence-based read on how safely an autonomous agent can actually drive your APIs, with a prioritized roadmap to raise it.
A human developer can paper over a lot of API friction — an ambiguous error, an undocumented idempotency convention, a prose-only auth description, an HTML-only changelog. An autonomous agent cannot. Every implicit convention a human silently absorbs is a place an agent gets stuck, retries blindly, double-charges a card, or hallucinates a payload. Agent readiness is the discipline of removing those implicit conventions and replacing them with machine-readable signals.
I score your public API surface against my open Agent Readiness framework — a nine-dimension model covering spec presence, auth-model clarity, idempotency, error semantics, rate-limit headers, dry-run, examples, MCP, and event contracts, plus the forward-looking signals of /.well-known/api-catalog, machine-readable consent, and identified agent traffic. Each dimension is scored 0–3 from a real evidence URL, and rolled up into an overall posture you can compare against reference providers like Stripe, GitHub, and Twilio.
Because the framework is public and I use it the same way across every provider on APIs.io, the number is neutral — not a badge I sell, but an honest outside read your teams and stakeholders can trust. It works as a one-time baseline, and it works even better as a before-and-after: score today, ship your improvements, and I re-score against the same rubric so you can prove exactly how far you moved.
What you walk away with
- A scored scorecard across all twelve dimensions, each backed by a specific evidence URL
- A prioritized remediation roadmap — what to fix, in what order, to move each dimension up
- A benchmark against reference and peer providers, so the score has market context
- A re-assessment pass that quantifies your improvement as a defensible delta
Related reading
- The Agent Readiness framework — the open nine-dimension model, schema, and vocabulary
- API Evangelist Scores 83% Agent Ready
- Making the API Evangelist Network Agent-Readable
- Reviews — the broader honest outside read on your APIs and governance
Let's work together
If you want a neutral third-party read on how agent-ready your APIs really are — and a clear path to raise it — that is exactly what I do. Let's talk.
