`get_act`

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

Return the full text of an entire act (all scenes within it). Use this to read a full structural unit at once. Returned object contains nested scenes with their speeches and lines.

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.

Example call

Arguments

{
  "author_id": "william-shakespeare",
  "work_slug": "hamlet",
  "act": 3
}

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

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "author_id": "oscar-wilde",
  "work_slug": "an-ideal-husband",
  "act": 3
}

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "description": "Error message when act 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"
        },
        "work_title": {
          "type": "string",
          "description": "Full title of the work"
        },
        "act": {
          "type": "number",
          "description": "Act number"
        },
        "scene_count": {
          "type": "number",
          "description": "Number of scenes in the act"
        },
        "scenes": {
          "type": "array",
          "description": "Array of all scenes within the act"
        }
      },
      "required": [
        "author_id",
        "work_slug",
        "act",
        "scene_count",
        "scenes"
      ]
    }
  ]
}

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_act