`quote_by_location`

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

Look up quotes by structural address within a work — act/scene for plays, chapter for novels. Example: author_id=“william-shakespeare”, work_title=“Hamlet”, act=3, scene=1 returns the “To be, or not to be” line.

Parameters

Name	Type	Required	Description
`author_id`	string	yes	Author id (e.g., “william-shakespeare”).
`work_title`	string	yes	Title of the work (e.g., “Hamlet”, “The Picture of Dorian Gray”).
`act`	number	no	Act number (plays only).
`scene`	number	no	Scene number (plays only).
`chapter`	number	no	Chapter number (novels/essays).

Example call

Arguments

{
  "author_id": "william-shakespeare",
  "work_title": "Hamlet",
  "act": 3,
  "scene": 1
}

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":"quote_by_location","arguments":{"author_id":"william-shakespeare","work_title":"Hamlet","act":3,"scene":1}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('quote_by_location', {
  "author_id": "william-shakespeare",
  "work_title": "Hamlet",
  "act": 3,
  "scene": 1
});

More examples

{
  "author_id": "oscar-wilde",
  "work_title": "The Picture of Dorian Gray",
  "chapter": 2
}

Response shape

Always returns: author_id, work, count, quotes

Field	Type	Description
`author_id`	string	Author id used for lookup
`work`	string	Work title that was queried
`count`	number	Number of quotes found at location
`quotes`	array	Array of quotes from the specified location

Full JSON Schema

{
  "type": "object",
  "properties": {
    "author_id": {
      "type": "string",
      "description": "Author id used for lookup"
    },
    "work": {
      "type": "string",
      "description": "Work title that was queried"
    },
    "count": {
      "type": "number",
      "description": "Number of quotes found at location"
    },
    "quotes": {
      "type": "array",
      "description": "Array of quotes from the specified location"
    }
  },
  "required": [
    "author_id",
    "work",
    "count",
    "quotes"
  ]
}

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.

quote_by_location