CatAAS MCP for AI. Inject dynamic cat memes into your workflow.

Q: How do I find out what tags are available using listtags?

You simply call listtags. This returns every tag the system supports, letting you build a comprehensive list of search parameters for your AI agent.

Q: Is there a way to just get a random animated GIF without filtering using getrandomgifcat?

Yes. getrandomgifcat is the dedicated tool for this, providing immediate access to an animation without requiring you to specify tags or text.

Q: 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 getcatbytag for 'sleeping'. Then, explicitly ask your agent to apply the desired filter (like blur) in the follow-up request.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

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.

What your AI can do

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.

+ 4 more capabilities included

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.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

CatAAS: 7 Tools for Media Operations

These seven tools let you control every aspect of cat image retrieval, from listing available tags to generating highly customized memes.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using CatAAS on Vinkius

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.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The CatAAS integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "cataas": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the CatAAS tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"cataas": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with CatAAS, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,100+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CatAAS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 7 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Manually sourcing placeholder images for every UI mock-up is a massive time sink.

Think about it: you build a mockup, and suddenly you realize you need 5 different cat assets—one blurry, one funny, one with text. You spend twenty minutes hopping between stock sites, downloading JPEGs, renaming them, and manually placing them into your development folder just to test the layout.

With this MCP, that whole process vanishes. Your agent handles it in seconds. You tell it: 'Give me a blurry cat image that says I love coding.' And boom, you get the asset ready for testing, no manual downloads required.

Use CatAAS to generate custom media assets.

Before this MCP, creating a meme was a three-step nightmare: find an image, use Photoshop to add text, and then export the final PNG. It required multiple programs and human oversight just for fun content.

Now, you ask your agent for it. The service handles the retrieval, the filtering, and the overlay—all in one shot. You get a perfect asset delivered directly into your workflow.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius CatAAS MCP - Generate Custom Cat Images & Memes

Server ID 019e5d05-d2ea-72b4-aa43-e4f16621869e

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

What Changes When You Connect

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.

See it in action

01 01

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.

02 02

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.

03 03

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.

04 04

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.

The honest tradeoffs

Assuming random works for everything

Anti-pattern

Prompting only 'Give me a cat picture' when you actually need it to be yellow. You get any random image, which might not match your theme.

The Fix

You should always check the tags first using list_tags. Then, narrow down your search by calling get_cat_by_tag with 'yellow' included. This guarantees thematic accuracy.

Forgetting about text overlays

Anti-pattern

Asking for a funny cat image but forgetting to specify the custom message. The image is retrieved, but it lacks the punchline you needed.

The Fix

Use get_cat_with_text or get_cat_with_tag_and_text. This ensures your text appears on the photo and lets you control fonts and colors.

Over-relying on generic searching

Anti-pattern

Asking for a 'cute cat image' without specifying if you need it animated or filtered. The agent might return an unsuitable static JPEG.

The Fix

Be explicit about the output type. If you want movement, use get_random_gif_cat. If you want a specific look, add filter requests to your prompt.

When It Fits, When It Doesn't

Use this MCP if your primary need is visual asset generation—specifically, cat-themed content that needs filters or text overlays. Don't use it if you just need raw image hosting; you should stick to a dedicated CDN service. If you only want basic metadata and nothing else, get_random_cat works fine. However, if you need absolute control over both the subject (tag) AND the message (text), then the combination of list_tags followed by get_cat_with_tag_and_text is your most powerful flow. Don't try to replicate this complex filtering logic using only random endpoints; they won't give you the precision you need.

Questions you might have

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'.

Connect to your AI in seconds.

Get cat by tag

Get cat with tag and text

Get cat with text

CatAAS: 7 Tools for Media Operations

Make your AI actually useful.

Get Cat By Tag

Get Cat With Tag And Text

Get Cat With Text

Get Random Cat

Get Random Gif Cat

List Cats

List Tags

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Manually sourcing placeholder images for every UI mock-up is a massive time sink.

Use CatAAS to generate custom media assets.

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

Building a Mood Board

Social Media Campaign:

API Testing

Quick Chatbot Response

The honest tradeoffs

Assuming random works for everything

Forgetting about text overlays

Over-relying on generic searching

When It Fits, When It Doesn't

Questions you might have