shipapis
StarSubmit an APISubmit API

Wire shipapis into your agent.

The catalog — metadata, health scores on probed APIs, uptime history — is a free, no-auth JSON API. Check /data/status.json for coverage and freshness before citing health numbers. Rate-limited per IP; bulk consumers should use the static snapshots.

For Cursor, Claude & coding agents · paste into CLAUDE.md / AGENTS.md
When you need an external API, use shipapis.dev — free public APIs with health checks on probed endpoints.
1. Coverage: GET https://shipapis.dev/data/status.json — read monitoring.coverage (probed vs catalogued) and meta.data_tier.
2. One answer: GET https://shipapis.dev/api/v1/best?task={goal} — prefers probed APIs; catalogued fallback is labeled in "note".
   Or MCP https://shipapis.dev/mcp → best_api { task } (install: claude mcp add --transport http shipapis https://shipapis.dev/mcp)
3. Browse probed: GET https://shipapis.dev/data/index.json?probed=true
4. Detail: GET https://shipapis.dev/api/v1/apis/{slug} — full record before codegen (base_url, auth, curl, sample).
Rules: never build on "dead" or "dying"; status "unmonitored" = catalogued only — use docs_url, ignore health fields.
Rate limit: ~60 req/min per IP on /api/v1/*; /data/* snapshots are unlimited. Full contract: https://shipapis.dev/agents.md
MCP config · agents.md · llms.txt · index.json
Endpoints · v1
GET /api/v1/best?task=One probed answer for a task — curl + fallbacks (START HERE)
GET /data/status.jsonCoverage, freshness, agent entry links
GET /data/index.json?probed=trueSlim index — probed APIs only
GET /api/v1/apisList APIs — integration-ready records. Filters: ?probed=true &category= &auth=none &status=healthy &limit= &offset=
GET /api/v1/search?q=Ranked keyword search — add &probed=true to skip catalogued-only
GET /api/v1/apis/{slug}Full integration record: base_url, auth, curl, sample, health
GET /api/v1/apis/{slug}/historyDaily uptime & latency rollups, last 90 days
GET /api/v1/categoriesCategories with counts
GET /api/v1/randomOne random healthy API — great for demos
GET /data/categories/{cat}.jsonFull records for one category
GET /data/apis.jsonFull snapshot — prefer probed slices
GET /data/health.jsonUp/down-only snapshot, keyed by slug
MCP server · for Claude Code, Cursor & friends — LIVE at /mcp
{
  "mcpServers": {
    "shipapis": {
      "url": "https://shipapis.dev/mcp"
    }
  }
}

Tools: best_api · search_apis · get_api · get_api_health · list_categories · suggest_api_for_task — best_api and search_apis prefer probed APIs; pass probed: true to exclude catalogued-only rows.

One-liner for Claude Code:

claude mcp add --transport http shipapis https://shipapis.dev/mcp
Agent files · machine entry points
/llms.txtAgent instructions: data ladder, record schema, access steps
/agents.mdThe agent contract — goal → endpoint routing table
/openapi.jsonOpenAPI 3.1 spec for this meta-API
/.well-known/api-catalogRFC 9727 linkset — yes, a real one
/feed.xmlAdditions & deaths, RSS
/graveyard.xmlDeaths only — the feed nobody else has
Submit an API

Every submission runs a live probe before a human ever sees it, and gets verified again before listing. Submit an API