`get_act`

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

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

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

{
  "type": "object",
  "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