Codex Pets
Integration guide

Codex Pets MCP integration guide

Use the public read-only MCP server when an agent should search approved Codex pet packs, fetch one pack, or generate install and share snippets without changing site data.By Codex Pets maintainers · Published May 27, 2026 · Updated July 29, 2026
MCP markdownServer card

How we tested

The Codex Pets maintainers ran these reproducible checks against the production deployment on July 29, 2026. Each one uses only public read-only routes, so any agent or human can repeat them verbatim.

List every approved pet as JSON

curl -s https://pets.ydb-qdrant.tech/api/manifest
{
  "generatedAt": "2026-07-29T21:16:26.515Z",
  "total": 146,
  "pets": [
    {
      "slug": "kesha",
      "displayName": "Kesha",
      "description": "A cheerful tan-and-white Pembroke Welsh corgi …",
      "installCommand": "npx @astandrik/codex-pets install kesha"
    },
    "… 145 more approved pets …"
  ]
}
Returned 146 approved pets when we ran it on July 29, 2026. (Run on July 29, 2026.)

Search pets by vibe

curl -s "https://pets.ydb-qdrant.tech/api/pets?q=anime&pageSize=3"
{
  "total": 3,
  "pets": [
    {
      "slug": "anime-girl-3",
      "displayName": "Anime Girl",
      "description": "A slightly chibi anime girl pet …",
      "tags": ["anime", "chibi", "sweater-dress"],
      "downloadCount": 53
    },
    "… 2 more matches …"
  ]
}
Top match on July 29, 2026: Anime Girl (anime-girl-3), a chibi anime pet. The MCP search_pets tool returns the same approved registry data. (Run on July 29, 2026.)

Get install instructions for a slug

curl -s https://pets.ydb-qdrant.tech/api/pets/anime-girl-3/install
{
  "slug": "anime-girl-3",
  "name": "Anime Girl",
  "install": {
    "command": "npx @astandrik/codex-pets install anime-girl-3",
    "codex": {
      "mcpServer": {
        "addCommand": "codex mcp add codexPets --url https://pets.ydb-qdrant.tech/mcp"
      }
    },
    "cursor": {
      "command": "npx @astandrik/codex-pets install anime-girl-3",
      "note": "…"
    },
    "claudeCode": {
      "command": "npx @astandrik/codex-pets install anime-girl-3",
      "note": "…"
    },
    "manual": { "steps": ["…"] }
  }
}
Returned CLI and manual install steps, including npx @astandrik/codex-pets install anime-girl-3 and the codex mcp add command. (Run on July 29, 2026.)

Which surface should your agent use?

SurfaceUse whenExample
MCP server (POST /mcp)The agent host supports MCP tool calls, such as Codex, Claude Code, or Cursor.search_pets, get_pet, get_install_instructions
OpenAPI + JSON routesThe agent only has plain HTTP access or needs a typed contract for codegen.GET /api/pets?q=anime, GET /openapi.json
llms.txt + markdown docsThe agent needs compact product context or docs in a single fetch.GET /llms-full.txt, GET /mcp.md

Connect

codex mcp add codexPets --url https://pets.ydb-qdrant.tech/mcp
curl -s https://pets.ydb-qdrant.tech/.well-known/mcp/server-card.json
curl -s https://pets.ydb-qdrant.tech/api/manifest

Tool choices

Example pets from this guide

Approved pets an agent can cite right now through any of the surfaces above.

Fallbacks

Related guides

Codex Pets MCP integration guide - Codex Pets