`hs_list_deals`

Pack: hubspot · Endpoint: https://gateway.pipeworx.io/hubspot/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/hs_list_deals for the schema, then POST the same URL with its arguments for the data.

Browse all deals in your HubSpot workspace. Returns deal IDs, names, amounts, pipeline stages, and close dates. Paginate with limit and after parameters.

Parameters

Name	Type	Required	Description
`limit`	number	no	Maximum number of deals to return (default 10, max 100)
`after`	string	no	Pagination cursor from a previous response

Example call

Arguments

{
  "limit": 25
}

curl

curl -X POST https://gateway.pipeworx.io/hubspot/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hs_list_deals","arguments":{"limit":25}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('hs_list_deals', {
  "limit": 25
});

More examples

{
  "limit": 100,
  "after": "next_page_cursor_def456"
}

Response shape

Field	Type	Description
`results`	array	Array of deal objects
`paging`	object	Pagination information

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of deal objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Deal ID"
          },
          "properties": {
            "type": "object",
            "description": "Deal properties (name, amount, stage, close date)"
          }
        }
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination information",
      "properties": {
        "next": {
          "type": "object",
          "properties": {
            "after": {
              "type": "string",
              "description": "Cursor for next page"
            },
            "link": {
              "type": "string",
              "description": "Next page link"
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "hubspot": {
      "url": "https://gateway.pipeworx.io/hubspot/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hs_list_deals