AgentsReady
Readiness index · #369 of 1846

ai21.com

Run the agent liveReport a change
59Readiness score / 100
L2 Agent-documentedBeats 79% of 1,846 companies
Access20/20
Context11/20
Interfaces28/32
Onboarding0/19
Trust0/9
llms.txt · root
MCP · https://docs.ai21.com/mcp
OpenAPI · https://api.ai21.com/openapi.json

Biggest gains

  1. +6 Docs available as markdown. Serve every docs page as .md, or honour Accept: text/markdown.
  2. +6 Agents can self-register OAuth clients. Support dynamic client registration (RFC 7591) or client ID metadata documents so MCP clients connect in one click.
  3. +5 OAuth discovery metadata. Publish RFC 8414 authorization-server and RFC 9728 protected-resource metadata.
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
  • FAILSDKs and a CLI4
  • FAILOAuth discovery metadata5
  • FAILAgents can self-register OAuth clients6
  • FAILSelf-serve API keys5
  • FAILFree tier or test mode3
  • FAILAgent manifests4
  • FAILsecurity.txt2
  • FAILPublic status page3

Your fix pack: 11 changes, up to +41 points

Each change is ready to paste, filled in for ai21.com, 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.ai21.com | head -5

Add the badge to your README

AgentsReady badge for ai21.com
[![AgentsReady](https://agentsready.dev/badge/ai21.com)](https://agentsready.dev/c/ai21.com)