Skip to content

list_my_deals ​

Read · Sign-in needed

Your deals, with their agreed terms

Lists every deal the signed-in account is a party to, across all its linked wallets: offers it made, deals it accepted, and offers waiting for its answer as a registration holder. This is the only list that includes each deal's agreed terms, and each row carries actions (what the account may do now) and stage. deal_type and status filter it; an unknown value is a 400, not an empty list. limit/offset page through total.

INFO

Not offered to ChatGPT or Codex.

Reads or changesReads only
Sign-inYes
Scopeapi:read
CallsGET /api/v2/deals/mine (API Explorer)

Input ​

JSON Schema, as the server serves it.

json
{
  "additionalProperties": false,
  "properties": {
    "deal_type": {
      "enum": [
        "buyout",
        "merge",
        "project_sale",
        "collab"
      ],
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Page size.",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Rows to skip.",
      "type": "integer"
    },
    "status": {
      "enum": [
        "draft",
        "pending",
        "announced",
        "paused",
        "payment_pending",
        "executing",
        "completed",
        "failed",
        "cancelled",
        "migrating",
        "closed"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Example ​

A tools/call request:

json
{
  "name": "list_my_deals",
  "arguments": {}
}

All MCP tools · Connect an AI app