crm_list_deals

List open CRM deals, optionally filtered by owner, stage, or account.

Category
CRM
Stability
Beta
Version
v1
Auth
cf-access

Input schema

{
  "type": "object",
  "properties": {
    "owner": { "type": "string", "description": "Rep username (e.g. 'rani')" },
    "stage": { "type": "string", "enum": ["lead", "qualified", "proposal", "won", "lost"] },
    "account_id": { "type": "string" },
    "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }
  }
}

Output schema

{
  "type": "object",
  "properties": {
    "deals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "deal_id": { "type": "string" },
          "account_id": { "type": "string" },
          "owner": { "type": "string" },
          "stage": { "type": "string" },
          "amount_eur": { "type": "number" },
          "next_step": { "type": "string" },
          "updated_at": { "type": "string", "format": "date-time" }
        }
      }
    }
  }
}

Example invocation

{
  "tool": "crm_list_deals",
  "arguments": { "owner": "rani", "stage": "qualified" }
}

Example response

{
  "deals": [
    {
      "deal_id": "D-2026-00084",
      "account_id": "ACME-0042",
      "owner": "rani",
      "stage": "qualified",
      "amount_eur": 8400.00,
      "next_step": "Send pricing by 2026-04-25",
      "updated_at": "2026-04-21T15:02:00Z"
    }
  ]
}

Primary listing surface for the sales workflow. Pairs with crm_advance_stage when a deal moves.