`get_scene`

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

Return the full text of a specific scene from a play (every speech, every line, in order). Example: author_id=“william-shakespeare”, work_slug=“hamlet”, act=3, scene=1 returns the entire “To be, or not to be” scene including all of Hamlet’s soliloquy and the subsequent dialogue with Ophelia. Useful for context, citation, or close reading.

Parameters

Name	Type	Required	Description
`author_id`	string	yes	Author id (e.g., “william-shakespeare”).
`work_slug`	string	yes	Work slug (e.g., “hamlet”).
`act`	number	yes	Act number.
`scene`	number	yes	Scene number.

Example call

Arguments

{
  "author_id": "william-shakespeare",
  "work_slug": "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":"get_scene","arguments":{"author_id":"william-shakespeare","work_slug":"hamlet","act":3,"scene":1}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "author_id": "william-shakespeare",
  "work_slug": "macbeth",
  "act": 5,
  "scene": 5
}

{
  "author_id": "oscar-wilde",
  "work_slug": "the-importance-of-being-earnest",
  "act": 1,
  "scene": 1
}

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "description": "Error message when scene not found"
        }
      },
      "required": [
        "error"
      ]
    },
    {
      "type": "object",
      "properties": {
        "author_id": {
          "type": "string",
          "description": "Author id of the work"
        },
        "work_slug": {
          "type": "string",
          "description": "Work slug identifier"
        },
        "act": {
          "type": "number",
          "description": "Act number"
        },
        "scene": {
          "type": "number",
          "description": "Scene number"
        },
        "setting": {
          "type": "string",
          "description": "Scene setting description"
        },
        "speech_count": {
          "type": "number",
          "description": "Number of speeches in the scene"
        },
        "speeches": {
          "type": "array",
          "description": "Array of speeches with speaker and lines"
        }
      },
      "required": [
        "author_id",
        "work_slug",
        "act",
        "scene",
        "setting",
        "speech_count",
        "speeches"
      ]
    }
  ]
}

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.

get_scene