@arpanstacy/stacy-mcp-server
v2026.505.1
Published
Model Context Protocol server for Stacy.
Readme
Stacy MCP Server
Model Context Protocol server for Stacy.
This package is a thin MCP wrapper over the existing Stacy 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:
STACY_API_URL- Stacy base URL, for examplehttp://localhost:3100STACY_API_KEY- bearer token used for/apirequestsSTACY_COMPANY_ID- optional default company for company-scoped toolsSTACY_AGENT_ID- optional default agent for checkout helpersSTACY_RUN_ID- optional run id forwarded on mutating requests
Usage
npx -y @arpanstacy/stacy-mcp-serverOr locally in this repo:
pnpm --filter @arpanstacy/stacy-mcp-server build
node packages/mcp-server/dist/stdio.jsTool Surface
Read tools:
stacyMestacyInboxLitestacyListAgentsstacyGetAgentstacyListIssuesstacyGetIssuestacyGetHeartbeatContextstacyListCommentsstacyGetCommentstacyListIssueApprovalsstacyListDocumentsstacyGetDocumentstacyListDocumentRevisionsstacyListProjectsstacyGetProjectstacyGetIssueWorkspaceRuntimestacyWaitForIssueWorkspaceServicestacyListGoalsstacyGetGoalstacyListApprovalsstacyGetApprovalstacyGetApprovalIssuesstacyListApprovalComments
Write tools:
stacyCreateIssuestacyUpdateIssuestacyCheckoutIssuestacyReleaseIssuestacyAddCommentstacySuggestTasksstacyAskUserQuestionsstacyRequestConfirmationstacyUpsertIssueDocumentstacyRestoreIssueDocumentRevisionstacyControlIssueWorkspaceServicesstacyCreateApprovalstacyLinkIssueApprovalstacyUnlinkIssueApprovalstacyApprovalDecisionstacyAddApprovalComment
Escape hatch:
stacyApiRequest
stacyApiRequest is limited to paths under /api and JSON bodies. It is
meant for endpoints that do not yet have a dedicated MCP tool.
