Skip to main content
POST
Node.js
See the WebMCP guide for SDK examples and invocation lifecycle details.

Authorizations

x-api-key
string
header
required

Path Parameters

id
string<uuid>
required

Session ID.

Body

application/json
toolRef
string
required
Required string length: 1 - 4096
input
object

Arguments matching the tool inputSchema. At most 1 MiB when JSON encoded. Keys are passed through unchanged.

timeoutSeconds
integer
default:60

Tool execution budget in seconds. Expiration requests cancellation; it does not guarantee rollback.

Required range: 1 <= x <= 120

Response

Success

status
enum<string>
required
Available options:
completed,
error,
canceled,
awaiting_submission
outputBytes
integer
required

Byte length of the original JSON output.

Required range: x >= 0
untrustedContent
boolean
required
durationMs
integer
required
Required range: x >= 0
invocationId
string

Handle for subsequent result reads or cancellation, when provided.

output
any

Any JSON value returned by the page, including null. Absent if unavailable or withheld for exceeding the output limit.

errorText
string
outputTruncated
boolean

True when output exceeds 1 MiB. Full output is withheld.

outputPreview
string

At most 4096 UTF-8 bytes of the oversized output; may be incomplete JSON.