Codex Pets Registry

Use to discover one or more approved public Codex pet packs by query, kind, tags, author, or Codex compatibility. Prefer this over get_pet when you do not already have an exact slug or need multiple candidates. Do not use for private generation requests or known-slug install/share snippets; use get_pet_request_info or a slug-specific get_* tool instead.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional text matched against approved pet names, descriptions, tags, and authors."
    },
    "kind": {
      "type": "string",
      "enum": [
        "all",
        "creature",
        "object",
        "character"
      ],
      "description": "Optional pet kind filter. Use all or omit the field to include every kind."
    },
    "tags": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Optional tag filter as a comma-separated string or array. All provided tags must match."
    },
    "author": {
      "type": "string",
      "description": "Optional author text matched against the public submitter name or verified public email."
    },
    "compatibleWith": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Optional compatibility filter. Use codex for Codex-compatible pets; other values return no matches."
    },
    "limit": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string"
        }
      ],
      "description": "Optional maximum result count. Defaults to 10 and is clamped to 1-60."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use when you already have an exact approved pet slug and need the sanitized public pet card, asset URLs, page URL, and install command for that one pet. Use search_pets first when you only have a name/query or need multiple results. Do not use for focused install, badge, embed, card, or request workflow details; use the matching get_* tool instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Exact slug of an approved public Codex pet."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use for a known approved pet slug when the user wants CLI or manual install instructions. Do not use to search for pets or inspect general metadata; use search_pets or get_pet instead. This tool is read-only and does not increment install or download counters.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Exact slug of an approved public Codex pet."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use for a known approved pet slug when the user needs README badge Markdown, HTML, or SVG URL. Do not use for animated README cards, website iframe embeds, install instructions, or pet discovery; use get_card_code, get_embed_code, get_install_instructions, or search_pets instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Exact slug of an approved public Codex pet."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use for a known approved pet slug when the user needs website iframe embed HTML or an embed URL. Do not use for README badges/cards, install instructions, or pet discovery; use get_badge_code, get_card_code, get_install_instructions, or search_pets instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Exact slug of an approved public Codex pet."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use for a known approved pet slug when the user needs animated README card Markdown, HTML, or GIF URL. Do not use for simple badges, website iframe embeds, install instructions, or pet discovery; use get_badge_code, get_embed_code, get_install_instructions, or search_pets instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Exact slug of an approved public Codex pet."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use when the user wants to request a new Codex pet or understand the public request form fields and reference image limits. Do not use to create, submit, update, or inspect private generation requests; no MCP tool exposes those operations. Use search_pets or get_pet for existing approved pets.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}