Cat Facts

liveEntertainment

Random cat facts and breed information via catfact.ninja

3tools
0msauth
free tier50 calls/day

Tools

get_fact

Get a random cat fact. Returns the fact text and character length. Use get_facts to retrieve multiple facts at once.

No parameters required.

▶Try it
list_breeds

Search cat breeds by name or list all available breeds. Returns breed name, country of origin, coat type, and pattern details.

Parameters
NameTypeDescription
limitoptnumberNumber of breeds to return. Defaults to 10.
▶Try it
get_facts

Get multiple random cat facts at once. Specify count (e.g., 5). Returns array of fact texts with character lengths.

Parameters
NameTypeDescription
limitoptnumberNumber of facts to return. Defaults to 5.
▶Try it

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/catfacts/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/catfacts/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_fact","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("get_fact", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("random cat facts and breed information via catfact");