`search_quotes`

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

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

Search quotes by keyword or phrase. Returns matching quotes with author names and topic tags.

Parameters

Name	Type	Required	Description
`query`	string	yes	Keyword or phrase to search for in quote content
`limit`	number	no	Number of results per page (1–100, default 20; rounded up to 10/25/50/100)

Example call

Arguments

{
  "query": "success"
}

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":"search_quotes","arguments":{"query":"success"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_quotes', {
  "query": "success"
});

More examples

{
  "query": "life and love",
  "limit": 10
}

Response shape

Always returns: total, count, page, total_pages, quotes

Field	Type	Description
`total`	number	Total matching quotes across all pages
`count`	number	Quotes returned on this page
`page`	number	Current page number
`total_pages`	number	Total number of pages
`quotes`	array	Matching quotes from search

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total matching quotes across all pages"
    },
    "count": {
      "type": "number",
      "description": "Quotes returned on this page"
    },
    "page": {
      "type": "number",
      "description": "Current page number"
    },
    "total_pages": {
      "type": "number",
      "description": "Total number of pages"
    },
    "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": "Matching quotes from search"
    }
  },
  "required": [
    "total",
    "count",
    "page",
    "total_pages",
    "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.

search_quotes