Agent-readable Codex pet registry
Find, install, and share approved Codex pets from your browser or directly from your AI coding agent. The catalog tools and HTTP read routes 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.generate_pet starts a server-paid text-to-pet task with limits of 200 tasks per day globally and 10 per IP.get_pet_generation returns its status, unlisted preview and ZIP. Results expire after 24 hours and are not published automatically.
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.