# Codex Pets

> Browse, preview, upload, and download community-made animated pet packs for Codex.

Codex Pets is a moderated community gallery for downloadable Codex pet packs. Each public pet page describes one approved animated companion and links to its ZIP package, pet.json metadata, and spritesheet.
Codex Pets is also an agent-readable registry. The public MCP endpoint and share routes expose approved read-only pet data plus read-only pet request workflow discovery.

Important notes:

- Pet spritesheets use an 8x9 atlas at 1536x1872.
- Public gallery and approved pet pages are intended for search and AI retrieval.
- Admin, account, and API mutation routes are not intended as retrieval sources.
- User-submitted pet pages are moderated before they appear in the public gallery.
- Public user pages list approved pet packs for a creator handle.
- Generated at 2026-06-08T20:44:33.982Z.

## Recommended assistant tasks

- Pick a pet by style.
- Explain a pet detail page.
- Generate install instructions.
- Connect MCP.
- Search pets through JSON, TOON, or MCP.
- Draft a pet request.
- Explain how to submit a pet.

## Core pages

- [Gallery](https://pets.ydb-qdrant.tech/): Browse approved Codex pet packs and search by name, description, kind, or tag.
- [About](https://pets.ydb-qdrant.tech/about): Learn how Codex Pets works, including the package format, npm CLI installer, and moderation flow.
- [Agents](https://pets.ydb-qdrant.tech/agents): Connect coding agents through MCP or the HTTP contract.
- [Developer portal](https://pets.ydb-qdrant.tech/developers): Find Codex Pets API docs, OpenAPI, MCP, authentication notes, and webhooks status.
- [API docs](https://pets.ydb-qdrant.tech/docs/api): Developer-facing Codex Pets HTTP API reference.
- [Markdown homepage](https://pets.ydb-qdrant.tech/index.md): Canonical markdown fallback for the site root.
- [Markdown about page](https://pets.ydb-qdrant.tech/about.md): Product description, authority notes, and off-site Wikipedia/Wikidata follow-up guidance.
- [Markdown agent access](https://pets.ydb-qdrant.tech/agents.md): Agent connection quickstart and when-to-use guidance.
- [Markdown developer portal](https://pets.ydb-qdrant.tech/developers.md): Developer resources in markdown.
- [Markdown API docs](https://pets.ydb-qdrant.tech/docs/api.md): API docs in markdown.
- [Markdown MCP docs](https://pets.ydb-qdrant.tech/mcp.md): MCP server and MCP App security notes.
- [Auth markdown](https://pets.ydb-qdrant.tech/auth.md): Public auth and access notes for agents.
- [Request a pet](https://pets.ydb-qdrant.tech/request): Send a private text brief and optional PNG, JPEG, or WebP reference image up to 5 MB for admins to review and fulfill manually.
- [Submit a pet](https://pets.ydb-qdrant.tech/submit): Upload a ZIP or pet.json plus spritesheet for moderation.
- Public user profile pages: https://pets.ydb-qdrant.tech/users/{handle}. Replace {handle} with a profile handle linked from approved pets.

## Machine-readable resources

- [Full LLM context](https://pets.ydb-qdrant.tech/llms-full.txt): Expanded agent-readable documentation with API reference, authentication notes, examples, and webhooks status.
- [Developer scoped llms.txt](https://pets.ydb-qdrant.tech/developers/llms.txt): Scoped developer resource map for API, OpenAPI, MCP, and auth discovery.
- [API scoped llms.txt](https://pets.ydb-qdrant.tech/docs/llms.txt): Scoped API and MCP route map for agent callers.
- [OpenAPI JSON](https://pets.ydb-qdrant.tech/openapi.json): Canonical OpenAPI 3.1 specification for the public Codex Pets API.
- [OpenAPI JSON alias](https://pets.ydb-qdrant.tech/api/openapi.json): API-prefixed OpenAPI URL for scanners that probe predictable resource names.
- [Sitemap](https://pets.ydb-qdrant.tech/sitemap.xml): Dynamic XML sitemap with public pages and approved pet pages.
- [Public manifest JSON](https://pets.ydb-qdrant.tech/api/manifest): Feed containing the current approved pet list, page URLs, install commands, and asset URLs.
- [Public manifest TOON](https://pets.ydb-qdrant.tech/api/manifest.toon): TOON mirror of the public manifest for LLM-friendly retrieval.
- [Public pet search JSON](https://pets.ydb-qdrant.tech/api/pets): Endpoint for approved pets. Optional query parameters: q, kind=all|creature|object|character, and comma-separated tags.
- [Public pet search TOON](https://pets.ydb-qdrant.tech/api/pets.toon): TOON mirror of public pet search with the same query parameters.
- [MCP endpoint](https://pets.ydb-qdrant.tech/mcp): Streamable HTTP MCP server exposing read-only tools for approved pets.
- [Well-known MCP endpoint](https://pets.ydb-qdrant.tech/.well-known/mcp): Well-known HTTP MCP discovery and POST alias.
- [MCP Registry metadata](https://pets.ydb-qdrant.tech/server.json): Public MCP Registry metadata for the remote server.
- [Well-known MCP Registry metadata](https://pets.ydb-qdrant.tech/.well-known/mcp/server.json): Well-known MCP metadata mirror.
- [MCP server card](https://pets.ydb-qdrant.tech/.well-known/mcp/server-card.json): Tool instructions, resource links, and MCP App resource metadata.
- [Pet request page](https://pets.ydb-qdrant.tech/request): Human-facing request form for generated pets. Required fields: contactEmail and prompt. Optional fields: requesterName, displayNameHint, kind, referenceImage.
- [Public tags JSON](https://pets.ydb-qdrant.tech/api/tags): Endpoint with current tag counts for approved pets.
- [Public tags TOON](https://pets.ydb-qdrant.tech/api/tags.toon): TOON mirror of current tag counts.
- Pet detail JSON: https://pets.ydb-qdrant.tech/api/pets/{slug}. Replace {slug} with an approved pet slug from the manifest.
- Pet detail TOON: https://pets.ydb-qdrant.tech/api/pets/{slug}.toon. Replace {slug} with an approved pet slug from the manifest.
- Pet share JSON: https://pets.ydb-qdrant.tech/api/pets/{slug}/share. Returns install, badge, and embed snippets without private contact fields or metrics.
- Pet install JSON: https://pets.ydb-qdrant.tech/api/pets/{slug}/install. GET is read-only and does not increment install counters.
- Badge SVG: https://pets.ydb-qdrant.tech/badge/{slug}.svg. README badge for an approved pet.
- Card GIF: https://pets.ydb-qdrant.tech/card/{slug}.gif. Animated GIF for an approved pet. Query params: mode=sprite|card, state, scale. Default sharable output is sprite-only.
- Embed page: https://pets.ydb-qdrant.tech/embed/{slug}. Iframe-friendly HTML for an approved pet. Query params: mode=sprite|card, state, scale, theme, compact, showInstall, showAuthor, showTags.

## Agent access

- Manifest: https://pets.ydb-qdrant.tech/api/manifest
- Manifest TOON: https://pets.ydb-qdrant.tech/api/manifest.toon
- MCP config: codex mcp add codexPets --url https://pets.ydb-qdrant.tech/mcp
- Well-known MCP config: https://pets.ydb-qdrant.tech/.well-known/mcp
- MCP tools: search_pets, get_pet, get_install_instructions, get_badge_code, get_embed_code, get_card_code, get_pet_request_info.
- List or search approved pets: https://pets.ydb-qdrant.tech/api/pets
- List or search approved pets as TOON: https://pets.ydb-qdrant.tech/api/pets.toon
- Fetch one approved pet: https://pets.ydb-qdrant.tech/api/pets/{slug}
- Fetch one approved pet as TOON: https://pets.ydb-qdrant.tech/api/pets/{slug}.toon
- Install command format: npx @astandrik/codex-pets install <slug>
- Browser WebMCP is optional and browser-only. It requires a runtime that exposes navigator.modelContext after the page loads.
- Browser WebMCP tools: search_codex_pets, get_codex_pet, get_codex_pets_manifest, get_codex_pet_request_info, get_current_codex_pet.

## Agent instructions: when to use Codex Pets

Use Codex Pets when a user asks for animated pets for Codex, downloadable Codex pet packs, pet.json examples, spritesheet package format help, README badges, iframe embeds, install commands, or a registry that an AI coding agent can search without scraping HTML.

Prefer MCP when the host supports tool calls. Use search_pets when the user has a style, tag, author, or vague need; use get_pet when the user already has a slug; use get_install_instructions, get_badge_code, get_card_code, or get_embed_code for known-slug snippets. Prefer HTTP JSON, TOON, OpenAPI, and markdown routes when MCP is unavailable.

Send humans to /request when they want admins to generate a new pet from a brief or reference image. Send humans to /submit when they already have a ZIP package or pet.json plus spritesheet ready for moderation.

Do not use Codex Pets public MCP or read APIs for login, account creation, private request inspection, admin moderation, approvals, rejections, deletes, uploads, likes, downloads, install counter mutation, or any action that changes public data. Those workflows stay in browser forms or private admin routes.

## Approved pet packs

- [Foggy Hedgehog](https://pets.ydb-qdrant.tech/pets/foggy-hedgehog): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: hedgehog, cartoon.
- [Yuffie](https://pets.ydb-qdrant.tech/pets/yuffie-3): Approved character Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: ffvii, anime, girl, final fantasy.
- [Ezhik](https://pets.ydb-qdrant.tech/pets/purple-hedgehog): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, round, smeshariki.
- [Cheburashka](https://pets.ydb-qdrant.tech/pets/cheburashka): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, oranges, chibi.
- [Krosh](https://pets.ydb-qdrant.tech/pets/blue-rabbit-2): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, rabbit, smeshariki.
- [Winnie](https://pets.ydb-qdrant.tech/pets/round-bear): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, bear.
- [Aerith](https://pets.ydb-qdrant.tech/pets/aerith-chibi-2): Approved character Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, girl, final fantasy, ffvii.
- [Neznayka](https://pets.ydb-qdrant.tech/pets/sunny-sprout): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, hat, blond.
- [Nu Pogodi Wolf](https://pets.ydb-qdrant.tech/pets/chibi-wolf): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: wolf, cartoon, nu pogodi.
- [Johnny Bravo](https://pets.ydb-qdrant.tech/pets/blond-flexer-2): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, flex, blond.
- [Karlson](https://pets.ydb-qdrant.tech/pets/karlson-2): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, funny, flying.
- [Doctor Livesey](https://pets.ydb-qdrant.tech/pets/bird-gentleman): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, doctor, treasure island.
- [Big Tyll](https://pets.ydb-qdrant.tech/pets/bolshoy-tyll): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, epic, creature.
- [Pushkin](https://pets.ydb-qdrant.tech/pets/pushkin-2): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: historical, person, writer.
- [Father Potets](https://pets.ydb-qdrant.tech/pets/otets-potets): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cartoon, tragic, old man.
- [Nozomi](https://pets.ydb-qdrant.tech/pets/nozomi-2): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: girl, anime, bodysuit.
- [Punk Anime Girl](https://pets.ydb-qdrant.tech/pets/punk-anime-girl): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, punk, chibi.
- [Anime Girl](https://pets.ydb-qdrant.tech/pets/anime-girl-3): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, sweater-dress.
- [Ice Crown Girl](https://pets.ydb-qdrant.tech/pets/ice-crown-girl): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, ice-crown, gothic-maid.
- [Ribbon Pop Diva](https://pets.ydb-qdrant.tech/pets/ribbon-pop-diva): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: `anime`, `idol`, `ribbon`.
- [Kuroa](https://pets.ydb-qdrant.tech/pets/kuroa): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, aqua-noir.
- [Velvet Luma](https://pets.ydb-qdrant.tech/pets/velvet-luma): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, gothic-chibi, sprite.
- [Noir](https://pets.ydb-qdrant.tech/pets/noir): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, noir, fantasy outfit.
- [Lavender Rogue](https://pets.ydb-qdrant.tech/pets/lavender-rogue): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, lavender, rogue.
- [Anime Chibi Girl](https://pets.ydb-qdrant.tech/pets/anime-chibi-girl): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, fantasy, adventurer.
- [Pink Catgirl](https://pets.ydb-qdrant.tech/pets/pink-catgirl): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, catgirl, pink, chibi.
- [Anime Girl](https://pets.ydb-qdrant.tech/pets/anime-girl-2): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, feminine.
- [Anime Elf](https://pets.ydb-qdrant.tech/pets/anime-elf-3): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, feminine.
- [Violet Rogue](https://pets.ydb-qdrant.tech/pets/violet-rogue): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, rogue, violet.
- [anime-elf-girl](https://pets.ydb-qdrant.tech/pets/anime-elf-girl): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, elf, chibi, fantasy.
- [Magenta Elf](https://pets.ydb-qdrant.tech/pets/magenta-elf): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, elf, chibi, magenta.
- [Anime Dancer](https://pets.ydb-qdrant.tech/pets/anime-dancer): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, dancer, feminine.
- [Anime Girl](https://pets.ydb-qdrant.tech/pets/anime-girl): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, fantasy.
- [BloodRayne](https://pets.ydb-qdrant.tech/pets/bloodrayne-2): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, red-haired, vampire-hunter.
- [Armored Anime Girl](https://pets.ydb-qdrant.tech/pets/armored-anime-girl): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, armored, masked, chibi.
- [Sakura Chibi](https://pets.ydb-qdrant.tech/pets/sakura-chibi): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, shinobi-girl.
- [Dante](https://pets.ydb-qdrant.tech/pets/dante-2): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: dante, devil may cry, chibi, red-coat.
- [2B](https://pets.ydb-qdrant.tech/pets/2b-2): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, android, chibi, nier-inspired.
- [Sans](https://pets.ydb-qdrant.tech/pets/sans): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: undertale, skeleton, pixel art.
- [Assassin](https://pets.ydb-qdrant.tech/pets/assassin): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: assasin, white clothes.
- [Velvet Crowe](https://pets.ydb-qdrant.tech/pets/velvet-crowe): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, dark-fantasy.
- [Quan Chi](https://pets.ydb-qdrant.tech/pets/quan-chi): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: mortal kombat, sorcerer, chibi.
- [Beetlejuice](https://pets.ydb-qdrant.tech/pets/beetlejuice-2): Approved character Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: beetlejuice, chibi, striped-suit, spooky.
- [Solara](https://pets.ydb-qdrant.tech/pets/solara): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, golden-armor, chibi-warrior.
- [Azure Girl](https://pets.ydb-qdrant.tech/pets/azure-girl): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, girl.
- [Anime Elf](https://pets.ydb-qdrant.tech/pets/anime-elf): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, elf, chibi.
- [Anime Elf Scout](https://pets.ydb-qdrant.tech/pets/anime-elf-scout): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, elf, adventurer.
- [Violet Petal](https://pets.ydb-qdrant.tech/pets/violet-petal): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime, chibi, violet-petal.
- [Azure Elf](https://pets.ydb-qdrant.tech/pets/azure-elf): Approved creature Codex pet pack. By [MartialArtsMaster](https://pets.ydb-qdrant.tech/users/martialartsmaster). Tags: anime-elf, chibi, teal-gold-outfit.
- [Ryuk](https://pets.ydb-qdrant.tech/pets/ryuk-2): Approved character Codex pet pack. By [stephano](https://pets.ydb-qdrant.tech/users/stephano). Tags: anime, dark-fantasy, chibi, shinigami.
- [Tifa Chibi](https://pets.ydb-qdrant.tech/pets/tifa-chibi): Approved character Codex pet pack. By [stephano](https://pets.ydb-qdrant.tech/users/stephano). Tags: final fantasy, fighter, game.
- [Mai Shiranui](https://pets.ydb-qdrant.tech/pets/mai-shiranui): Approved character Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, kunoichi, fighting-game.
- [Pyramid Head](https://pets.ydb-qdrant.tech/pets/pyramid-head): Approved character Codex pet pack. By [stephano](https://pets.ydb-qdrant.tech/users/stephano). Tags: silent hill, monster, creepy.
- [Sephiroth](https://pets.ydb-qdrant.tech/pets/sephiroth-2): Approved character Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: final fantasy, sword, antagonist.
- [Gordon Freeman](https://pets.ydb-qdrant.tech/pets/gordon-freeman): Approved character Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: half life, man, freeman.
- [Cloud](https://pets.ydb-qdrant.tech/pets/cloud-flat-2): Approved character Codex pet pack. By [astandrik](https://pets.ydb-qdrant.tech/users/astandrik). Tags: cloud, final fantasy, sword.
- [Catgirl Chibi](https://pets.ydb-qdrant.tech/pets/catgirl-chibi): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, catgirl, chibi, fantasy.
- [Street Chibi](https://pets.ydb-qdrant.tech/pets/street-chibi-3): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: anime, chibi, streetwear, sticker.
- [Aurelia](https://pets.ydb-qdrant.tech/pets/aurelia): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: girl, anime, gold.
- [Kitsune Chibi](https://pets.ydb-qdrant.tech/pets/kitsune-chibi-2): Approved creature Codex pet pack. By [jrpg fan](https://pets.ydb-qdrant.tech/users/jrpg-fan). Tags: neko, anime, girl.


The approved pet list is truncated to 60 entries. Use the public manifest for the full current list.

## Optional

- [Robots policy](https://pets.ydb-qdrant.tech/robots.txt): Crawl policy for search and AI crawlers.