DealHub MCP Server
DealHub is a quote-to-cash platform unifying CPQ (Configure, Price, Quote), CLM, subscription management, and DealRooms. Use it to manage quotes, opportunities, versions, product catalogs, and users.
What is the DealHub MCP Server?
The DealHub MCP server gives AI agents structured, permission-aware access to DealHub through the Model Context Protocol. With 23 pre-built actions, agents can read, create, and update DealHub data on behalf of authorized users.
Willow ships the DealHub MCP server as part of an enterprise control plane. Every call runs behind SSO (Okta, Azure AD), enforces RBAC and least-privilege at runtime, writes to a full audit trail, and integrates with Splunk and Loki for SIEM visibility. Connect from Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, n8n, or any custom agent. Install once, distribute org-wide, and see exactly how DealHub is being used by every AI agent in your stack.
Tools
Get Quote
Retrieve a single quote by its DealHub Quote ID. Use the `feature` parameter to control the level of detail returned (use 'all' for the complete quote including line items, playbook answers, approvals, summary and DealRoom info). Set `external_identifier_flag` to true to look the quote up by its CRM external quote id instead.
List Quotes
Retrieve a paginated list of quotes. Filter by `external_opportunity_id` to only return quotes linked to a specific CRM opportunity. Use `feature` to control detail per quote (use 'all' for full detail), and `offset`/`limit` for pagination (default limit 50, max 50).
Get DealHub Quote ID
Resolve the internal `dealhub_quote_id` from a `dealhub_proposal_id` (the proposal/quote number visible in the DealHub UI). Use this to translate a user-facing proposal id into the id required by other quote endpoints.
Get Quote Document
Download the output document (PDF, Word, or Excel) for a submitted quote. By default returns the format the salesperson generated; use `document_type` to request a different format (only works if enabled for the quote's playbook). Not supported for draft quotes.
Create Opportunity
Create a new opportunity in DealHub (typically used for renewal automation). Requires the CRM opportunity id/name, the opportunity owner details, currency, and CRM customer id/name.
Get DealRoom Signers
Retrieve the signing status of a DealRoom contract for a CRM opportunity — returns the DealRoom state along with buyer-side and seller-side signers (name, title, company, signature date).
Simulate Quote
Synchronously calculate quote pricing and line items for a given configuration WITHOUT creating a persistent quote. Ideal for real-time price calculations. Requires a `version_id` and EITHER `external_opportunity_id` OR both `geo_code` and `currency` (providing both options errors). `quote_data` is required (send [] if you have no answers).
Generate Quote
Create an official quote record in DealHub, link it to a CRM opportunity, and initiate approval workflows. Asynchronous — returns immediately while processing continues in the background. `request_action` controls the target state (draft/submit/publish/sign_externally). Tip: call 'Get Generate Quote Template' first to get the exact playbook structure for `quote_data` and `line_items`.
Submit Quote
Asynchronously submit an existing Draft quote for approval. Use `line_item_details` to control the level of detail in the response.
Publish Quote
Asynchronously publish an existing 'Ready to be sent' quote to a DealRoom. Use `line_item_details` to control the level of detail in the response.
Sign Quote Externally
Asynchronously mark an existing quote as Won (signed outside DealHub). The quote must be in 'Ready to be sent' or 'Published' status. A `sign_externally_comment` is required.
List Versions
Retrieve the list of CPQ versions (which encapsulate products, pricing and API configuration). Optionally filter by status (DRAFT, ACTIVE, DEACTIVATED).
Get Version by ID
Retrieve a specific CPQ version by its unique DealHub version id.
Get Version by Name
Retrieve a specific CPQ version by its name.
Get Version Products
Retrieve a paginated list of products (and bundles) for a specific version, including basic attributes and price details. For ACTIVE/DEACTIVATED versions, `product_option` can return either all products or only new/modified ones.
Get Products by SKU
Retrieve basic details for a specific list of product SKUs from the catalog. If some SKUs are not found in the version, the response returns 200 with an error note in the `info` structure.
Get Playbook Data
Export a playbook's configuration and data (question groups, questions, answers, and metadata) as JSON for a specific version. Use this to understand the playbook structure before generating a quote.
Get Generate Quote Template
Return a preformatted JSON template for the Generate Quote API based on a playbook's structure. Use the returned template as the starting point (quote_data groups/questions and line_items) for the 'Generate Quote' tool.
List Users
Retrieve the list of DealHub users. Optionally filter by active/inactive status. Fields with null values are omitted from the response.
Get User by ID
Retrieve a single user's details by their DealHub user id.
Get User by Login
Retrieve a single user's details by their login name.
Create or Update Users
Create new users or update existing ones (identified by the immutable `login` field). Each user requires login, email, name, external_user_id, and is_active.
Get Async Request Status
Poll the status of an asynchronous DealHub request (e.g. generate quote, duplicate/activate version, product catalog upload). Returns status (in-progress/done/failed/queued) and any error details for a given request_id.
Customize Tools
Edit descriptions, modify arguments, select tools, or add new ones
Set Up Your DealHub MCP Server in Minutes
Add the following configuration to your MCP client. Authentication is handled via OAuth. Compatible with Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code, n8n, and any MCP-compatible agent.
Claude Desktop
{
"mcpServers": {
"willow-dealhub": {
"type": "http",
"url": "https://<org>.mcp-s.com/mcp/mcp/dealhub"
}
}
}Cursor
{
"mcpServers": {
"willow-dealhub": {
"type": "http",
"url": "https://<org>.mcp-s.com/mcp/mcp/dealhub"
}
}
}Claude Code
claude mcp add willow-dealhub --transport http https://<org>.mcp-s.com/mcp/mcp/dealhubn8n
{
"url": "https://<org>.mcp-s.com/mcp/mcp/dealhub",
"method": "POST"
}Or click "Install with Willow" above to set up automatically with SSO and RBAC preconfigured.
Enterprise Governance for DealHub
Willow adds the layer DealHub and every other SaaS doesn't ship out of the box: every call runs behind SSO (Okta, Azure AD), enforces RBAC and least-privilege at runtime, writes to full audit logs, and detects shadow AI usage across your stack. One MCP gateway. Any agent. Every tool.
DealHub MCP Server FAQ
What is the DealHub MCP server?
The DealHub MCP server is a Model Context Protocol implementation that lets AI agents like Claude, Cursor, and ChatGPT read and write DealHub data through a standardized interface. Willow hosts and governs this server so enterprises can roll it out without a security review backlog.
How is Willow's DealHub MCP server different from the official one?
The official DealHub MCP server is scoped to a single user's account and does not include enterprise governance. Willow's version adds SSO, RBAC, audit logging, shadow AI detection, and centralized control over which actions agents can take across the entire org.
Which AI clients work with the DealHub MCP server?
Claude Desktop, Claude Code, Cursor, ChatGPT, VS Code with MCP support, n8n, and any custom agent built with OpenAI Agents SDK, LangChain, Vercel AI SDK, or Anthropic SDK.
Is the DealHub MCP server secure? How does Willow handle authentication?
Every call runs behind your existing SSO (Okta, Azure AD). Per-user OAuth scopes the agent to exactly what that user can do in DealHub, nothing more. No credentials reach the LLM. Every action writes to an audit trail.
Can I limit which DealHub actions agents can take?
Yes. Willow lets you scope agents to specific actions, specific projects, or specific environments. Toggle actions on or off in the dashboard, or enforce policy via infrastructure-as-code through GitHub.
How do I detect shadow DealHub MCP servers in my org?
Willow's browser extension and discovery service surface unmanaged MCP servers, skills, and AI agents across the org. If a developer installed an unapproved DealHub MCP locally, you'll see it.
What does the DealHub MCP server cost?
Pricing depends on org size and deployment model (SaaS, dedicated cloud, self-host). See withwillow.ai/pricing or contact sales for a quote.
How do I install the DealHub MCP server with Willow?
Install via the Willow Connect Panel in one click, or paste the JSON snippet above into your Claude Desktop, Cursor, or Claude Code config. SSO and RBAC inherit from your existing Willow setup.
Compare Willow MCP Gateway
See how Willow stacks up against other MCP platforms on governance, security, and enterprise readiness.
Your agents are already in the wild.
Give them a Basecamp. Go from AI chaos to AI work, in minutes.