Agent-readable Codex pet registry
Find, install, and share approved Codex pets from your browser or directly from your AI coding agent. The MCP server and HTTP routes are read-only and return approved public registry data plus request workflow discovery.Connect Codex
codex mcp add codexPets --url https://pets.ydb-qdrant.tech/mcp
Or add the Streamable HTTP server to config.toml:[mcp_servers.codexPets]
url = "https://pets.ydb-qdrant.tech/mcp"
Open an AI assistant with MCP, manifest, and API setup context.
MCP tools
search_pets searches approved pets by query, kind, tags, author, and compatibility.get_pet returns one sanitized public pet card.get_install_instructions returns CLI and manual install instructions without incrementing metrics.get_badge_code returns Markdown and HTML README badge snippets.get_embed_code returns iframe embed code.get_card_code returns Markdown and HTML animated card snippets.get_pet_request_info returns the public request page, required fields, and reference image limits without creating a request.
HTTP contract
/api/manifest lists approved pets with install commands and asset URLs./api/manifest.toon, /api/pets.toon, /api/pets/<slug>.toon, and /api/tags.toon mirror the core JSON registry data in TOON./api/pets searches approved pets with q kind, and comma-separated tags query parameters./api/pets/<slug>/share returns install, badge, and embed snippets./request is the public form for asking admins to generate a new Codex pet./badge/<slug>.svg and /embed/<slug> are public share surfaces.