AgentsReady
Readiness index · #159 of 1846

codat.io

Run the agent liveReport a change
74Readiness score / 100
L3 Agent-operableBeats 91% of 1,846 companies
Access20/20
Context11/20
Interfaces32/32
Onboarding11/19
Trust0/9
llms.txt · root
MCP · https://mcp.codat.io/
OpenAPI · https://api.codat.io/swagger/v1/swagger.json

Biggest gains

  1. +6 Docs available as markdown. Serve every docs page as .md, or honour Accept: text/markdown.
  2. +5 Self-serve API keys. Show how to create a key on the first docs page. No sales call.
  3. +4 Agent manifests. Publish an MCP server card (/.well-known/mcp.json) or A2A agent card.
All 20 checks
  • PASSAgents get the real page, not a bot wall10
  • PASSrobots.txt lets user-triggered agents in6
  • PASSContent is server-rendered4
  • PASSllms.txt exists8
  • FAILllms-full.txt exists3
  • FAILDocs available as markdown6
  • PASSSitemap2
  • PASSStructured metadata1
  • PASSPublic developer docs4
  • PASSMachine-readable API spec8
  • PASSRemote MCP server for the product12
  • PASSDocs MCP or searchable docs4
  • PASSSDKs and a CLI4
  • PASSOAuth discovery metadata5
  • PASSAgents can self-register OAuth clients6
  • FAILSelf-serve API keys5
  • FAILFree tier or test mode3
  • FAILAgent manifests4
  • FAILsecurity.txt2
  • FAILPublic status page3

Your fix pack: 8 changes, up to +26 points

Each change is ready to paste, filled in for codat.io, with a command to check it worked. Or hand the whole list to your coding agent.

HTML docs cost an agent 3 to 10 times more tokens than the same page in markdown, and lose structure.

Where: Your docs site (middleware or docs-platform setting)
// Next.js docs site: middleware.ts — serve /page.md and honour Accept: text/markdown
import { NextResponse, type NextRequest } from "next/server";

export function middleware(req: NextRequest) {
  const url = req.nextUrl.clone();
  const wantsMd = req.headers.get("accept")?.includes("text/markdown");
  if (url.pathname.endsWith(".md") || wantsMd) {
    const slug = url.pathname.replace(/\.md$/, "") || "/index";
    url.pathname = `/api/markdown${slug}`; // route that returns the page's MDX source as text/markdown
    return NextResponse.rewrite(url);
  }
}
// Mintlify / Fern / GitBook / ReadMe: .md pages are built in. Check they're enabled.
Check it worked:curl -s -H "Accept: text/markdown" https://docs.codat.io | head -5

Add the badge to your README

AgentsReady badge for codat.io
[![AgentsReady](https://agentsready.dev/badge/codat.io)](https://agentsready.dev/c/codat.io)