Agents

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 only approved public registry data.

MCP endpoint Public manifest

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"

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.

HTTP contract

/api/manifest lists approved pets with install commands and asset URLs.
/api/pets searches approved pets with q and kind query parameters.
/api/pets/<slug>/share returns install, badge, and embed snippets.
/badge/<slug>.svg and /embed/<slug> are public share surfaces.