CATAAS

live Animals

Cat as a Service — random cat images, tag-filtered cats, and available tag listings

3 tools

0ms auth

free tier 50 calls/day

Tools

random_cat

Get a random cat image from CATAAS (Cat as a Service). Returns the image URL, cat ID, and associated tags.

No parameters required.

▶ Try it

Response

cat_by_tag required: tag

Get a random cat image matching a specific tag from CATAAS. Use list_tags first to discover available tags. Returns the image URL, cat ID, and tags.

Parameters

Name Type Description

tag req string Tag to filter cats by (e.g. "cute", "orange", "grumpy"). Use list_tags to see available tags.

▶ Try it

Response

list_tags

List all available cat tags on CATAAS. Use these tags with cat_by_tag to find cats of a specific type or appearance.

No parameters required.

▶ Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

curl -X POST https://gateway.pipeworx.io/cataas/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

curl -X POST https://gateway.pipeworx.io/cataas/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"random_cat","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("random_cat", {});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("cat as a service — random cat images, tag-filtered cats, and available tag listings");

Related packs

Other Pipeworx packs in the same categories (Animals):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-cataas": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/cataas/mcp"
      ]
    }
  }
}