# CatAAS MCP > CatAAS provides a direct connection to the Cat as a Service API, letting your AI client pull random cat images and animated GIFs on demand. You can filter by specific tags like 'sleeping' or 'funny,' overlay custom text for instant memes, or apply visual filters like blur or mono. It turns simple image retrieval into a dynamic content creation tool. ## Overview - **Category:** design-creative - **Price:** Free - **Tags:** cats, memes, gifs, image-generation, fun ## Description This MCP lets you inject fun, customized visuals into your AI interactions. Forget manually searching through stock photo sites; you just tell your agent what kind of cat you need—maybe something 'cute' that's also 'sleeping'—and it handles the rest. You can create instant memes by asking for a specific image and having custom text dropped right on top. If you need to change the mood, you can even apply professional filters like negative or sepia tones. Getting started is simple; just connect this MCP via Vinkius, and your agent gets access to all the cat assets it needs. ## Tools ### get_cat_by_tag Retrieves a random cat picture that matches a specific tag you provide. ### get_cat_with_tag_and_text Gets a random cat image that matches a tag and overlays custom text on it. ### get_cat_with_text Creates an image with custom text overlaid, regardless of tags or specific cat types. ### get_random_cat Fetches basic metadata for a completely random cat image. ### get_random_gif_cat Pulls a random animated GIF of a cat. ### list_cats Lists all the available categories or types of cat entries in the database. ### list_tags Returns a list of every single tag currently defined and usable for filtering. ## Prompt Examples **Prompt:** ``` Get a random cat image with a 'blur' filter. ``` **Response:** ``` I've fetched a blurred cat image for you. [Image ID: 596e421d844c04001011cc98] ``` **Prompt:** ``` Show me a cat with the tag 'orange' saying 'I am hungry'. ``` **Response:** ``` Here is an orange cat with your custom text overlay. [Image ID: 596e421f844c04001011cc9a] ``` **Prompt:** ``` List all available cat tags. ``` **Response:** ``` I've retrieved the tags. Popular ones include 'cute', 'orange', 'sleeping', 'black', and 'funny'. There are hundreds more available! ``` ## Capabilities ### Retrieve Random Cat Media Gets a random high-quality image or animated GIF of a cat without needing any specific search criteria. ### Filter Cats by Tag Searches the database for cats matching one or more defined tags, like 'orange' or 'black'. ### Generate Text-Overlaid Memes Creates a custom image by placing specific text—and choosing fonts/colors—onto a random cat photo. ### Combine Tags and Text Searches Finds a cat that matches both a specified tag and a required overlaid text phrase. ### Apply Visual Filters Modifies the retrieved image by applying filters like blur, grayscale, or adjusting brightness/saturation. ## Use Cases ### Building a Mood Board A UX designer needs 10 diverse placeholder images for a design review. Instead of finding 10 different stock photos, they prompt their agent to use `get_random_cat` ten times and ask the agent to apply alternating filters (mono, blur) to simulate variety. ### Social Media Campaign: A marketing associate needs a set of meme assets for Twitter. They prompt their agent: 'Give me an orange cat with the tag 'funny' that says 'Nap time.''. The agent uses `get_cat_with_tag_and_text` to generate the perfect, ready-to-post visual. ### API Testing A developer is writing a test suite for an image display component. They use `list_tags` first to see all available tags, then loop through them using `get_cat_by_tag` to ensure the UI handles varied tag inputs correctly. ### Quick Chatbot Response A customer service bot needs a lighthearted response. Instead of text, it uses `get_random_gif_cat`, ensuring the conversation feels personal and engaging instantly. ## Benefits - Stop wasting time on simple placeholders. You can use the `get_random_cat` tool to grab a basic image metadata fetch for rapid UI prototyping during development. - Need specific content? Don't just guess tags. Use `list_tags` first, then feed those results into `get_cat_by_tag` to guarantee you find exactly what you need. - Want text on the image *and* a filter applied? You have to combine calls: First use `get_cat_with_text`, and then ask your agent to apply a specific filter like 'blur' in the next step. - Creating complex memes is easy. By combining `list_tags` with `get_cat_with_tag_and_text`, you can ensure both the subject (the tag) and the message (the text) are perfect. - If all you need is quick fun, the `get_random_gif_cat` tool delivers an animated GIF instantly. No tags, no fuss—just a random cat GIF to brighten someone's day. ## How It Works The bottom line is that you write the request once, and the MCP handles all the complex data fetching and formatting for you. 1. Subscribe to this MCP via Vinkius and connect your preferred AI client. 2. Prompt your agent with what you need: 'Give me a cute cat meme saying hi.' 3. The agent calls the necessary tool, retrieves the asset, and delivers the resulting image or GIF directly. ## Frequently Asked Questions **How do I find out what tags are available using list_tags?** You simply call `list_tags`. This returns every tag the system supports, letting you build a comprehensive list of search parameters for your AI agent. **Can I make a meme that is both tagged and has custom text using get_cat_with_tag_and_text?** Yes. This tool handles the complex logic: it finds an image matching the tag, then overlays your specified text onto that exact cat photo. **Is there a way to just get a random animated GIF without filtering using get_random_gif_cat?** Yes. `get_random_gif_cat` is the dedicated tool for this, providing immediate access to an animation without requiring you to specify tags or text. **What if I want a cat that's sleeping but also needs a specific filter applied?** You'll need a multi-step prompt. First, use `get_cat_by_tag` for 'sleeping'. Then, explicitly ask your agent to apply the desired filter (like blur) in the follow-up request. **What's the best practice for calling `get_random_cat` if I need to generate a large batch of images?** You should check our rate limit guidelines before running bulk requests. The MCP is designed for natural agent usage, so rapid-fire calls might hit temporary throttling limits. If you anticipate high volume, use an asynchronous workflow instead. **When I run `list_cats`, what specific data points does the returned metadata include?** The output provides structured records for every cat entry. Expect to receive primary IDs, associated tags, and key details about the image source. This data allows your agent to build highly customized queries. **If I use `get_cat_with_text` with special characters in my custom message, will it fail?** No, the MCP handles common encoding issues automatically. You generally don't need to worry about escaping quotes or foreign letters. Just input the text naturally, and it gets overlaid correctly. **Does `get_random_cat` give me a usable image file, or just metadata?** It delivers detailed JSON metadata that points to the asset location. Your AI client uses this structured data to build the final URL and display the cat image for you. **Can I add custom text to the cat images to create memes?** Yes! Use the `get_cat_with_text` tool. You can specify the text, font size, and even font color to create the perfect cat meme in seconds. **How do I find out which tags are available for filtering?** You can use the `list_tags` tool. It will return a comprehensive list of all categories and keywords used in the CatAAS database. **Is it possible to apply visual filters like 'blur' or 'grayscale'?** Absolutely. Most tools like `get_random_cat` support a `filter` parameter where you can choose options like 'blur', 'mono', or 'negate'.