`random_quote`

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

Return a random quote from the corpus, optionally filtered by author, fame, verification status, or tag. Each result includes citation: work, year, speaker (for plays/fiction), and source URL.

Parameters

Name	Type	Required	Description
`author_id`	string	no	Optional author id (e.g., “oscar-wilde”, “william-shakespeare”, “mark-twain”). Use list_authors to discover ids.
`famous_only`	boolean	no	If true, only return famous/canonical quotes.
`verified_only`	boolean	no	If true, exclude misattributed quotes.
`tag`	string	no	Filter by tag (e.g., “wit”, “love”, “misattributed”, “commonly-misquoted”).

Example call

Arguments

{
  "famous_only": true,
  "verified_only": true
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('random_quote', {
  "famous_only": true,
  "verified_only": true
});

More examples

{
  "author_id": "oscar-wilde",
  "tag": "wit"
}

{
  "author_id": "william-shakespeare",
  "famous_only": true
}

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "description": "Error message when no quotes match filters"
        }
      },
      "required": [
        "error"
      ]
    },
    {
      "type": "object",
      "description": "Random quote with full citation details"
    }
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

random_quote