AgentsReady
Readiness index · #555 of 1846

gitpod.io

Run the agent liveReport a change
51Readiness score / 100
L2 Agent-documentedBeats 69% of 1,846 companies
Access10/20
Context17/20
Interfaces24/32
Onboarding0/19
Trust0/9
llms.txt · docs
MCP · https://docs.gitpod.io/mcp

Biggest gains

  1. +8 Machine-readable API spec. Publish an OpenAPI spec at a stable URL like /openapi.json and link it from llms.txt.
  2. +6 robots.txt lets user-triggered agents in. Don't Disallow ChatGPT-User, Claude-User or Perplexity-User. Block training crawlers separately if you must.
  3. +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.
All 20 checks
  • PASSAgents get the real page, not a bot wall10
  • FAILrobots.txt lets user-triggered agents in6
  • FAILContent is server-rendered4
  • PASSllms.txt exists8
  • PASSllms-full.txt exists3
  • PASSDocs available as markdown6
  • FAILSitemap2
  • FAILStructured metadata1
  • PASSPublic developer docs4
  • FAILMachine-readable API spec8
  • PASSRemote MCP server for the product12
  • PASSDocs MCP or searchable docs4
  • PASSSDKs 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: 13 changes, up to +49 points

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

An OpenAPI spec is the contract agents and SDK generators build against. Without it they guess from prose.

Where: https://gitpod.io/openapi.json, linked from llms.txt and the API reference
// Serve the spec your API framework already generates (FastAPI: /openapi.json is built in).
// Next.js: app/openapi.json/route.ts
import spec from "@/openapi/openapi.json";
export const GET = () => Response.json(spec, { headers: { "Access-Control-Allow-Origin": "*" } });

// Every operation needs: operationId, summary, description, request/response examples,
// and the auth scheme (components.securitySchemes) so agents know how to send the key.
Check it worked:curl -s https://gitpod.io/openapi.json | head -c 200

Add the badge to your README

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