# The Cat MCP for AI Agents AI Agent Connect > The Cat MCP lets you browse the world's largest collection of cat images and manage a personal gallery through your AI client. You can search for specific breeds, get detailed characteristics, and save your favorites or vote on images directly. It also supports uploading your own cat photos to the API using base64 data. ## Overview - **Category:** image-video - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_CiZgsGVyO1gxZ5ZglkYHL3EEA6SoQDTxYTuEqLNQ/ai-agent-connect - **Tags:** cats, feline, animals, pets, images ## Description If you're a cat person, you know that finding the perfect picture of a specific breed or keeping track of your favorite felines can be a chore. This Connector changes that by putting the power of The Cat API directly into your AI's hands. Instead of jumping between tabs and manually saving URLs, you can just ask your agent to find a Maine Coon or pull up a list of all known cat breeds. It handles the heavy lifting of fetching breed characteristics and image data for you. You can even build out a personalized library by saving images to your favorites or casting votes on what you see. It's a way to turn your AI into a dedicated pet research assistant or a personal gallery manager. Because Vinkius hosts this, you can plug it into your existing workflow and start interacting with feline data immediately. Whether you're a dev testing image handling or a content creator looking for specific visual assets, it makes the process of finding and organizing cat content much faster. ## Tools ### create_favourite Save a specific image to your personal favorites list. This helps you build a curated gallery of your favorite cats. ### create_vote Cast an up or down vote on a cat image. Use this to interact with the community's content. ### get_favourites Retrieve all the images you've saved to your favorites. It quickly pulls up your personal collection. ### get_image Pull the specific details and metadata for a single cat image. This provides deep info on a specific photo. ### get_votes See the voting history for your account. This lets you track your interactions with the API content. ### list_breeds Get a complete list of every cat breed in the database. Use this to see the full scope of available breeds. ### search_breeds Search for a specific breed by name to see its traits. This is perfect for finding detailed breed characteristics. ### search_images Search for cat images using filters like breed or size. It helps you find exactly the right feline photo. ### upload_image Upload your own cat photo to the API using base64 encoding. This adds your personal photos to the public database. ## Prompt Examples **Prompt:** ``` Find me some pictures of Siamese cats that are small. ``` **Response:** ``` I've found a few small Siamese cats for you: | Breed | Size | Image ID | | :--- | :--- | :--- | | Siamese | Small | cat_9921 | | Siamese | Small | cat_4432 | Would you like to see the full characteristics for any of these? ``` **Prompt:** ``` Tell me about the Bengal breed. ``` **Response:** ``` The **Bengal** breed is known for the following traits: * **Intelligence**: High * **Energy**: Very Active * **Coat**: Leopard-like spots * **Personality**: Playful and curious It's a striking breed for anyone looking for a high-energy companion. ``` **Prompt:** ``` What are my favorite cats? ``` **Response:** ``` I've pulled up your favorite feline images. You have 3 saved: * **Siamese Cat** (ID: cat_9921) * **Maine Coon** (ID: cat_1102) * **Persian Cat** (ID: cat_5567) Let me know if you'd like to see the details for any of these. ``` ## Capabilities ### Search cat images Find specific photos based on breed, size, or type. ### Get breed info Retrieve detailed characteristics for any known cat breed. ### Manage favorites Save specific cat images to your personal collection. ### Cast votes Upvote or downvote images within the API. ### Upload photos Add your own cat images to the API using base64 data. ## Use Cases ### Researching breed traits for a blog A writer asks for the personality of a Maine Coon. The agent uses search_breeds to pull facts and search_images to find photos. ### Building a personal cat gallery A user wants to save a specific Siamese cat they found. The agent uses create_favourite to add it to their collection. ### Finding specific cat types for media A designer needs a small cat in a GIF format. The agent uses search_images with size and type filters to find it. ### Uploading personal pet photos A user wants to share their kitten. They provide a base64 string and the agent uses upload_image to put it on the API. ## Benefits - No more manual searching: Use search_images to find exactly what you need without browsing external websites. - Instant breed facts: Get detailed characteristics for any breed using list_breeds or search_breeds. - Organized favorites: Keep track of your top picks using create_favourite and get_favourites. - Easy content sourcing: Quickly find specific types of cats for your projects with search_images. - Direct image uploads: Add your own photos to the database using upload_image. - Voting history: Keep track of your interactions with the community using create_vote. ## How It Works The bottom line is you get a direct line to a massive cat image database without leaving your chat interface. 1. Subscribe to the Connector on Vinkius and get your API key from The Cat API. 2. Add the credentials to your preferred AI client like Claude or Cursor. 3. Ask your agent to find breeds, search images, or manage your favorites. ## Frequently Asked Questions **Can I use The Cat MCP to find specific cat breeds?** Yes, it lets your agent search for any breed by name and provide detailed characteristics for each one directly in your chat. **How do I save images to my favorites with The Cat MCP?** You just ask your agent to save a specific image you found, and it uses the tool to add it to your personal collection automatically. **Can I upload my own cat photos using The Cat MCP?** Yes, you can provide a base64 string of your own photo, and the agent will upload it to the API for you. **Does The Cat MCP work with Claude or Cursor?** It works with any MCP-compatible client, including Claude, Cursor, and Windsurf. **How does The Cat MCP help with content creation?** It helps you quickly find specific feline breeds and high-quality images for your media projects without manual searching. **Can I see my voting history with The Cat MCP?** Yes, your agent can retrieve all the votes you've cast on images through the API. **How do I find high-quality cat images of a specific breed?** You can use the `search_images` tool and specify the `size` as 'full' and `has_breeds` as true. To find a specific breed's ID first, use the `search_breeds` tool. **Can I see all the images I have previously favorited?** Yes! Use the `get_favourites` tool. It will retrieve a list of all cat images you have saved to your account. **How do I cast a vote on a cat image?** Use the `create_vote` tool. You'll need the `image_id` and a `value` (1 for an upvote, 0 for a downvote).