API reference

MCP tool reference

The 5 tools served at http://staging.tabductor.com/api/mcp. This page is generated from the server itself, so it always matches what the endpoint accepts. Parameter names are snake_case.

workflow_publish — Publish workflow
workflow_update — Update workflow
workflow_trigger — Run workflow
workflow_status — Workflow status and result
workflow_schedule — Schedule workflow

workflow_publish

Publish workflow

Create a workflow from one directing prompt and an optional final JSON result schema.

Parameter	Type	Required	Description
`prompt`	`string`	Yes	minLength: 1, maxLength: 20000
`result_schema`	`object \| boolean`	No	Optional JSON Schema draft-07 for the workflow's final JSON result.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "result_schema": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {}
        },
        {
          "type": "boolean"
        }
      ],
      "description": "Optional JSON Schema draft-07 for the workflow's final JSON result."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

workflow_update

Update workflow

Replaces existing state

Replace the directing workflow prompt and optional result schema, then publish the rebuilt workflow.

Parameter	Type	Required	Description
`workflow_id`	`string`	Yes	minLength: 1
`prompt`	`string`	Yes	minLength: 1, maxLength: 20000
`result_schema`	`object \| boolean`	No	Optional JSON Schema draft-07 for the workflow's final JSON result.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "minLength": 1
    },
    "prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "result_schema": {
      "anyOf": [
        {
          "type": "object",
          "additionalProperties": {}
        },
        {
          "type": "boolean"
        }
      ],
      "description": "Optional JSON Schema draft-07 for the workflow's final JSON result."
    }
  },
  "required": [
    "workflow_id",
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

workflow_trigger

Run workflow

Start the full published workflow from all entry tasks. Individual events cannot be manually triggered.

Parameter	Type	Required	Description
`workflow_id`	`string`	Yes	minLength: 1
`inputs`	`object`	No	Values for $variable-name references, keyed by name without $. propertyNames: {"pattern":"^[A-Za-z_][A-Za-z0-9_](?:-[A-Za-z0-9_]+)$"}
`request_id`	`string`	No	Reuse this request ID when retrying an uncertain response; a new ID starts new work. minLength: 1, maxLength: 200

Input JSON Schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "minLength": 1
    },
    "inputs": {
      "type": "object",
      "additionalProperties": {
        "type": "string",
        "maxLength": 20000
      },
      "propertyNames": {
        "pattern": "^[A-Za-z_][A-Za-z0-9_]*(?:-[A-Za-z0-9_]+)*$"
      },
      "description": "Values for $variable-name references, keyed by name without $."
    },
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Reuse this request ID when retrying an uncertain response; a new ID starts new work."
    }
  },
  "required": [
    "workflow_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

workflow_status

Workflow status and result

Read-onlySafe to repeat

Poll the executionId returned by workflow_trigger. When finished is true, resultReady indicates whether the final JSON result is available. Failed or cancelled executions include errors.

Parameter	Type	Required	Description
`workflow_id`	`string`	Yes	minLength: 1
`execution_id`	`string`	Yes	minLength: 1

Input JSON Schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "minLength": 1
    },
    "execution_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "workflow_id",
    "execution_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

workflow_schedule

Schedule workflow

Safe to repeat

Publish a cron schedule for a workflow's entry behavior.

Parameter	Type	Required	Description
`workflow_id`	`string`	Yes	minLength: 1
`cron`	`string`	Yes	minLength: 1
`timezone`	`string`	No	minLength: 1
`enabled`	`boolean`	No

Input JSON Schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "type": "string",
      "minLength": 1
    },
    "cron": {
      "type": "string",
      "minLength": 1
    },
    "timezone": {
      "type": "string",
      "minLength": 1
    },
    "enabled": {
      "type": "boolean"
    }
  },
  "required": [
    "workflow_id",
    "cron"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}