`get_facts`

Pack: catfacts · Endpoint: https://gateway.pipeworx.io/catfacts/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_facts for the schema, then POST the same URL with its arguments for the data.

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

Parameters

Name	Type	Required	Description
`limit`	number	no	Number of facts to return. Defaults to 5.

Example call

Arguments

{
  "limit": 5
}

curl

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

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_facts', {
  "limit": 5
});

More examples

{
  "limit": 10
}

Response shape

Always returns: total, facts

Field	Type	Description
`total`	number	Total number of available facts
`facts`	array	List of cat facts

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of available facts"
    },
    "facts": {
      "type": "array",
      "description": "List of cat facts",
      "items": {
        "type": "object",
        "properties": {
          "fact": {
            "type": "string",
            "description": "The cat fact text"
          },
          "length": {
            "type": "number",
            "description": "Character length of the fact"
          }
        },
        "required": [
          "fact",
          "length"
        ]
      }
    }
  },
  "required": [
    "total",
    "facts"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "catfacts": {
      "url": "https://gateway.pipeworx.io/catfacts/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_facts