Skip to content

get_deal ​

Read · No sign-in

Get one deal with its history

Returns one deal with its event history, attestations and payment records; stage, deadline and deadline_kind say where it stands and which clock is running. Public: anyone with the id can read it. With a wallet session the answer also carries actions (what that wallet may do now); anonymously actions is null, a collab's agreed terms are removed from its events, and signatures on attestations are blanked. terms is never on this read; it is only on the parties' own list of their deals.

INFO

Not offered to ChatGPT or Codex.

Reads or changesReads only
Sign-inNo
CallsGET /api/v2/deals/{dealId} (API Explorer)

Input ​

JSON Schema, as the server serves it.

json
{
  "additionalProperties": false,
  "properties": {
    "dealId": {
      "description": "The deal's id (a UUID, as returned in `deal.id` / `dealId`).",
      "format": "uuid",
      "type": "string"
    }
  },
  "required": [
    "dealId"
  ],
  "type": "object"
}

Example ​

A tools/call request:

json
{
  "name": "get_deal",
  "arguments": {
    "dealId": "value"
  }
}

All MCP tools · Connect an AI app