@dealdesk/mcp-server
v2026.603.0
Published
Model Context Protocol server for DealDesk.
Downloads
1,217
Readme
DealDesk MCP Server
Model Context Protocol server for DealDesk.
This package is a thin MCP wrapper over the existing DealDesk REST API. It does not talk to the database directly and it does not reimplement business logic.
Authentication
The server reads its configuration from environment variables:
DEALDESK_API_URL- DealDesk base URL, for examplehttp://localhost:3100DEALDESK_API_KEY- bearer token used for/apirequestsDEALDESK_COMPANY_ID- optional default company for company-scoped toolsDEALDESK_AGENT_ID- optional default agent for checkout helpersDEALDESK_RUN_ID- optional run id forwarded on mutating requests
Usage
npx -y @dealdesk/mcp-serverOr locally in this repo:
pnpm --filter @dealdesk/mcp-server build
node packages/mcp-server/dist/stdio.jsTool Surface
Read tools:
dealdeskMedealdeskInboxLitedealdeskListAgentsdealdeskGetAgentdealdeskListIssuesdealdeskGetIssuedealdeskGetHeartbeatContextdealdeskListCommentsdealdeskGetCommentdealdeskListIssueApprovalsdealdeskListDocumentsdealdeskGetDocumentdealdeskListDocumentRevisionsdealdeskListProjectsdealdeskGetProjectdealdeskGetIssueWorkspaceRuntimedealdeskWaitForIssueWorkspaceServicedealdeskListGoalsdealdeskGetGoaldealdeskListApprovalsdealdeskGetApprovaldealdeskGetApprovalIssuesdealdeskListApprovalComments
Write tools:
dealdeskCreateIssuedealdeskUpdateIssuedealdeskCheckoutIssuedealdeskReleaseIssuedealdeskAddCommentdealdeskSuggestTasksdealdeskAskUserQuestionsdealdeskRequestConfirmationdealdeskUpsertIssueDocumentdealdeskRestoreIssueDocumentRevisiondealdeskControlIssueWorkspaceServicesdealdeskCreateApprovaldealdeskLinkIssueApprovaldealdeskUnlinkIssueApprovaldealdeskApprovalDecisiondealdeskAddApprovalComment
Escape hatch:
dealdeskApiRequest
dealdeskApiRequest is limited to paths under /api and JSON bodies. It is
meant for endpoints that do not yet have a dedicated MCP tool.
