`random_quote`

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

Get a random quote, optionally filtered by tag (e.g., “Wisdom”, “Motivational”) or author slug. Returns quote text, author, and tags. Tags come from a fixed list — call list_tags to see it.

Parameters

Name	Type	Required	Description
`limit`	number	no	Number of quotes to return (1–10, default 1)
`tags`	string	no	Filter by tag(s) from list_tags. Comma for AND, pipe for OR, e.g. “Wisdom” or “Humorous\|Science”. Case is normalised for you.
`author`	string	no	Filter by author slug, e.g. “albert-einstein”

Example call

Arguments

{
  "limit": 1
}

curl

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

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "limit": 5,
  "tags": "Wisdom",
  "author": "albert-einstein"
}

Response shape

Full JSON Schema

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Quote unique identifier"
        },
        "content": {
          "type": "string",
          "description": "Quote text"
        },
        "author": {
          "type": "string",
          "description": "Author name"
        },
        "author_slug": {
          "type": "string",
          "description": "Author slug for filtering"
        },
        "length": {
          "type": "number",
          "description": "Character count of quote"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Topic tags for the quote"
        }
      },
      "required": [
        "id",
        "content",
        "author",
        "author_slug",
        "length",
        "tags"
      ]
    },
    {
      "type": "object",
      "properties": {
        "count": {
          "type": "number",
          "description": "Number of quotes returned"
        },
        "quotes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Quote unique identifier"
              },
              "content": {
                "type": "string",
                "description": "Quote text"
              },
              "author": {
                "type": "string",
                "description": "Author name"
              },
              "author_slug": {
                "type": "string",
                "description": "Author slug for filtering"
              },
              "length": {
                "type": "number",
                "description": "Character count of quote"
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Topic tags for the quote"
              }
            },
            "required": [
              "id",
              "content",
              "author",
              "author_slug",
              "length",
              "tags"
            ]
          },
          "description": "Array of random quotes"
        }
      },
      "required": [
        "count",
        "quotes"
      ]
    }
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

random_quote