get_post_events

Get a post's history with Wavegrain's MCP server: the get_post_events tool needs the read permission. Inputs, outputs and an example call.

Get a post's history. Permission: read. Read-only: changes nothing.

One post's history from a get_post_status delivery id, oldest first: each step and network call with result and request id, and its state now with the reason.

Inputs

InputTypeRequiredNotes
deliveryIdstringyesA delivery id from get_post_status. up to 200 characters

The fields inside an object or a list are in the JSON Schema at /developers/mcp-tools.json.

Returns

FieldTypeNotes
deliveryIdstringThe delivery.
networkstringThe network.
accountNamestring | nullThe account it posts to.
status"queued" | "preparing" | "sending" | "processing" | "action_required" | "outcome_unknown" | "published" | "failed" | "cancelled"The post's status on this account: queued (waiting for its time), preparing and sending (on its way), processing (the network is processing it), action_required (waiting in the account's inbox; the person finishes it in the network's app), outcome_unknown (it may or may not have posted; the person checks, then marks it posted or sends it again), published, failed, cancelled. label is the same in words.
automaticbooleanTrue when it posts by itself from the Calendar.
scheduledForstringWhen it posts or posted, ISO 8601.
reasonstring | nullWhy it failed or is unconfirmed, in words the user can act on.
eventsobject[]Oldest first. Network calls are kept 30 days.

Example call

Send it to POST https://wavegrain.com/api/mcp with an access key that has the read permission; Authentication shows how to make one.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_post_events",
    "arguments": {
      "deliveryId": "<deliveryId>"
    }
  }
}

The call shows only the required inputs, with placeholder values: put your own in.

Something wrong or missing? Write to support@wavegrain.com.