{"_id":"@heliyos/heliyos-mcp","_rev":"7-520799dc6279009bb3ea672bc3dd3733","name":"@heliyos/heliyos-mcp","dist-tags":{"latest":"1.0.5"},"versions":{"0.0.0-stage":{"name":"@heliyos/heliyos-mcp","version":"0.0.0-stage","_id":"@heliyos/heliyos-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"dist":{"shasum":"4c36a732c83b6f2761728193954762c2866964ee","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-3RKgv7DZz0P+SJf8b5tYSvpJPpM5r2NuWY7mdICwBMXtKBpCU4bCWfYryS2Ywb+WJuvt/QqYsqHWn4dG9t11uw==","signatures":[{"sig":"MEUCIQCvhAKvXcXQQDGLirWzJfaZ5zzZkvgo2laA/49tWxbJZAIgLpmiE93D2gLy0IKhKhjLfgfMd2mCifQpHEDGPzbOqJk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":342},"_npmUser":{"name":"rcsiit1","email":"rajan@heliyos.ai"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"@heliyos/heliyos-mcp","version":"1.0.0","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"license":"MIT","_id":"@heliyos/heliyos-mcp@1.0.0","maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"homepage":"https://docs.heliyos.ai/mcp/overview","bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"bin":{"heliyos-mcp":"dist/src/bin/stdio.js"},"dist":{"shasum":"793b6096f45049368d0f54e9476b6fe228931bf2","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-1.0.0.tgz","fileCount":81,"integrity":"sha512-6WOlK2FGneY4Kv/b9flV55Bqh1IK8wnF7+TehecTqgsij37Q69Pr4l+nSSK9abBtH+qgQ1dwBW7hkIXuPMFixQ==","signatures":[{"sig":"MEUCIQDkzz7zoAFmlvM3SfO9dJRUJ32mTavi+7LEO9BIG4pqbwIgK2Pb+E4gdfVmFtugliXgFg7XZ0ZBWcOgm9LkJfo+QHM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIA0MJlqwC7wfwxXsPqRoqUdrF6OEbdLr2mqlPZF4Wf4jAiBYJXf4rsT6kHf1sSRKacRGmzcqJWkonA1JyKMWFzgsrA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":578893},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"5594a6191503fa30bb95be1747a19d42bee1c6ed","mcpName":"ai.heliyos/crm","scripts":{"test":"vitest run","build":"npm run clean && npm run codegen && tsc -p tsconfig.json","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","smoke":"HELIYOS_MCP_SMOKE=1 vitest run tests/smoke.live.test.ts","codegen":"node scripts/codegen.mjs","typecheck":"tsc -p tsconfig.test.json","readme:tools":"npm run build && node scripts/tool-table.mjs","sync-openapi":"node scripts/sync-openapi.mjs","install-links":"node scripts/cursor-link.mjs","prepublishOnly":"npm run prepublish:check && npm run build && npm test","prepublish:check":"node scripts/prepublish-check.mjs","test:update-tool-snapshot":"UPDATE_TOOL_SNAPSHOT=1 vitest run tests/toolList.snapshot.test.ts"},"_npmUser":{"name":"rcsiit1","email":"rajan@heliyos.ai"},"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","directories":{},"_nodeVersion":"23.1.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","msw":"^2.15.0","vitest":"^2.1.9","typescript":"~5.9.3","@types/node":"^22.20.5","ajv-formats":"^3.0.1","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/heliyos-mcp_1.0.0_1793979773210_0.43773335502826427","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@heliyos/heliyos-mcp","version":"1.0.1","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"license":"MIT","_id":"@heliyos/heliyos-mcp@1.0.1","maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"homepage":"https://docs.heliyos.ai/mcp/overview","bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"bin":{"heliyos-mcp":"dist/src/bin/stdio.js"},"dist":{"shasum":"67307bba4769b162412aaa17eb80990973c2cc64","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-1.0.1.tgz","fileCount":81,"integrity":"sha512-N60utwBhMiQkbWwXoaqCEVBXlMeWGh35d28+brz++jL+sduYrIAkZsfDuy/kGDUgRHMiqgVkaoQpITMWJ4iW9w==","signatures":[{"sig":"MEQCIGanmOrCx4/yFxorlUypgCVzF7mV5tDXOpDC4p2ZLgv6AiBdIwpxAd6ySwaHYyeCssqnp3J8nG5/WXrZQaCEggAY8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCppCmuqgZTxfImM48DCKqUIGpYXp6cUZtQKMgNorgkfAIhAOJGzRx6IOfCCEFemXmKFkmJKP4Ajy315hhi/fXOeJa8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@heliyos%2fheliyos-mcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":578893},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"8f54d43fdb1814d0659ca9186afa82bfb24e7df4","mcpName":"ai.heliyos/crm","scripts":{"test":"vitest run","build":"npm run clean && npm run codegen && tsc -p tsconfig.json","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","smoke":"HELIYOS_MCP_SMOKE=1 vitest run tests/smoke.live.test.ts","codegen":"node scripts/codegen.mjs","typecheck":"tsc -p tsconfig.test.json","readme:tools":"npm run build && node scripts/tool-table.mjs","sync-openapi":"node scripts/sync-openapi.mjs","install-links":"node scripts/cursor-link.mjs","prepublishOnly":"npm run prepublish:check && npm run build && npm test","prepublish:check":"node scripts/prepublish-check.mjs","test:update-tool-snapshot":"UPDATE_TOOL_SNAPSHOT=1 vitest run tests/toolList.snapshot.test.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"2fc6965a-f299-4346-a7b2-c172e3a64a71"}},"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","directories":{},"_nodeVersion":"22.23.4","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","msw":"^2.15.0","vitest":"^2.1.9","typescript":"~5.9.3","@types/node":"^22.20.5","ajv-formats":"^3.0.1","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/heliyos-mcp_1.0.1_1793980880920_0.21242056822101152","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@heliyos/heliyos-mcp","version":"1.0.2","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"license":"MIT","_id":"@heliyos/heliyos-mcp@1.0.2","maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"homepage":"https://docs.heliyos.ai/mcp/overview","bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"bin":{"heliyos-mcp":"dist/src/bin/stdio.js"},"dist":{"shasum":"4488702874d3e6eaf51272ea8563d50c14336479","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-1.0.2.tgz","fileCount":81,"integrity":"sha512-LlfDuXDZRFLNye1Nb1v/gnk2o9XSn45YYPtKsj3lj2HazksfP4WPF9gQ5DtGUqep5+BLP8z/Q0Ob9fyFmCSXBQ==","signatures":[{"sig":"MEUCIQDO2CVIVJivdRGNsXRuSBS4aJZ0hBEmSGzU/+PTQ+P8swIgKPuX28kcYwVlZl/MskzHe0g4nJi9DPxZEnK4OxGdZzk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAbxT71PuRX0DUxLhqtfuwaqPj0ggXd1mRF37qjds92mAiEAvtC3Z9xZV69OpJ0cgdt2acbYJQkWDId6O8XDsxPmZEU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@heliyos%2fheliyos-mcp@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":578917},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"3ea1b2266691093d1fd8ceed53827769c5c7611a","mcpName":"ai.heliyos/heliyos-mcp","scripts":{"test":"vitest run","build":"npm run clean && npm run codegen && tsc -p tsconfig.json","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","smoke":"HELIYOS_MCP_SMOKE=1 vitest run tests/smoke.live.test.ts","codegen":"node scripts/codegen.mjs","typecheck":"tsc -p tsconfig.test.json","readme:tools":"npm run build && node scripts/tool-table.mjs","sync-openapi":"node scripts/sync-openapi.mjs","install-links":"node scripts/cursor-link.mjs","prepublishOnly":"npm run prepublish:check && npm run build && npm test","prepublish:check":"node scripts/prepublish-check.mjs","test:update-tool-snapshot":"UPDATE_TOOL_SNAPSHOT=1 vitest run tests/toolList.snapshot.test.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"2fc6965a-f299-4346-a7b2-c172e3a64a71"}},"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","directories":{},"_nodeVersion":"22.23.4","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","msw":"^2.15.0","vitest":"^2.1.9","typescript":"~5.9.3","@types/node":"^22.20.5","ajv-formats":"^3.0.1","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/heliyos-mcp_1.0.2_1793982452874_0.4002339578176466","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@heliyos/heliyos-mcp","version":"1.0.3","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"license":"MIT","_id":"@heliyos/heliyos-mcp@1.0.3","maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"homepage":"https://docs.heliyos.ai/mcp/overview","bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"bin":{"heliyos-mcp":"dist/src/bin/stdio.js"},"dist":{"shasum":"448efd855e351906d03f5a35cb1052e41ff5ad27","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-1.0.3.tgz","fileCount":81,"integrity":"sha512-Z74wO/XLr2e4A2xzu0ssi1iE2l8dcbXtqMd9fIOfri0cWy/7jVIyIe3990moghfbOB1hU+C5npXKdHNJlM7QMg==","signatures":[{"sig":"MEUCIFGmaVkyHmRd8C7p+SrnBjR27acekIbEPCDYF/Tftf3QAiEA4V15U7KatKifcIp5BJxq+bccMUrYjTV1NuN3kB2cLcc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEzN/HUEjcNAnt53tmXIStPYPpqNrE6QT2gmDbKGNWHYAiBSvZ1SKwurNoTa8jEGQD9I+5Zo31dO7D1hPfpeBgqC7w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@heliyos%2fheliyos-mcp@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":578917},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"24e2c641bf10ec3417a56e345c615dc04a78ccec","mcpName":"ai.heliyos/heliyos-mcp","scripts":{"test":"vitest run","build":"npm run clean && npm run codegen && tsc -p tsconfig.json","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","smoke":"HELIYOS_MCP_SMOKE=1 vitest run tests/smoke.live.test.ts","codegen":"node scripts/codegen.mjs","typecheck":"tsc -p tsconfig.test.json","readme:tools":"npm run build && node scripts/tool-table.mjs","sync-openapi":"node scripts/sync-openapi.mjs","install-links":"node scripts/cursor-link.mjs","prepublishOnly":"npm run prepublish:check && npm run build && npm test","prepublish:check":"node scripts/prepublish-check.mjs","test:update-tool-snapshot":"UPDATE_TOOL_SNAPSHOT=1 vitest run tests/toolList.snapshot.test.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"2fc6965a-f299-4346-a7b2-c172e3a64a71"}},"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","directories":{},"_nodeVersion":"22.23.4","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","msw":"^2.15.0","vitest":"^2.1.9","typescript":"~5.9.3","@types/node":"^22.20.5","ajv-formats":"^3.0.1","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/heliyos-mcp_1.0.3_1793983366156_0.04212414131418085","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@heliyos/heliyos-mcp","version":"1.0.4","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"license":"MIT","_id":"@heliyos/heliyos-mcp@1.0.4","maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"homepage":"https://docs.heliyos.ai/mcp/overview","bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"bin":{"heliyos-mcp":"dist/src/bin/stdio.js"},"dist":{"shasum":"fec5e0e2ae39b19a45493a0d05b3bdd340d95d86","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-1.0.4.tgz","fileCount":85,"integrity":"sha512-T1b88x/eWNHLuFQ0bEzZTMtdJRbqcMrSG0Bl4kfb6HW6yGhQkmZzCXdunCIpwVKqVdpxI7AOEirivYFlx7NaMw==","signatures":[{"sig":"MEUCIQCpvVKdZQVmkrMeZqcSlcbi+cKVe6uSIpDbln8O0Lha4gIgbQ2L28hI9rRfmQQqFWDAzEWkZGeM1nxH1oReS4+gbqc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBodGPL/V4BPMoNpVz2sWQChBYqTQul7QyAF7y721+y9AiAgYYwZZZEkMDjgnSAi1QUTR9JAw2RsYMLae229xi/4Lg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@heliyos%2fheliyos-mcp@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":588763},"main":"dist/src/index.js","type":"module","types":"dist/src/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"46f6afb171d7ddf5881a1da714ab838bff80f4ee","mcpName":"ai.heliyos/heliyos-mcp","scripts":{"test":"vitest run","build":"npm run clean && npm run codegen && tsc -p tsconfig.json","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","smoke":"HELIYOS_MCP_SMOKE=1 vitest run tests/smoke.live.test.ts","codegen":"node scripts/codegen.mjs","typecheck":"tsc -p tsconfig.test.json","readme:tools":"npm run build && node scripts/tool-table.mjs","sync-openapi":"node scripts/sync-openapi.mjs","install-links":"node scripts/cursor-link.mjs","prepublishOnly":"npm run prepublish:check && npm run build && npm test","prepublish:check":"node scripts/prepublish-check.mjs","test:update-tool-snapshot":"UPDATE_TOOL_SNAPSHOT=1 vitest run tests/toolList.snapshot.test.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"2fc6965a-f299-4346-a7b2-c172e3a64a71"}},"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","directories":{},"_nodeVersion":"22.23.4","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","msw":"^2.15.0","vitest":"^2.1.9","typescript":"~5.9.3","@types/node":"^22.20.5","ajv-formats":"^3.0.1","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"tmp":"tmp/heliyos-mcp_1.0.4_1793987033068_0.32364405797758256","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"_id":"@heliyos/heliyos-mcp@1.0.5","bin":{"heliyos-mcp":"dist/src/bin/stdio.js"},"bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"dist":{"shasum":"e754b0850cff21a7d263c2e9693306eb71a003ca","tarball":"https://registry.npmjs.org/@heliyos/heliyos-mcp/-/heliyos-mcp-1.0.5.tgz","fileCount":85,"integrity":"sha512-BcMPDkO/qKWFHQhQtZtScFb45oRGHGc9TBvduqOSMVzaUG05vJEh9RQJGVt/OUPb9z0E9S5MYpSJt2IMDV3z8Q==","signatures":[{"sig":"MEQCIBgJ2IM2UYfInuy08E+WcK7J55CXDF20XcMpO7kbtrP8AiAnDUxz6PM18eitC7vi9EAyihwnO0a/nb4enA1YNAKdVA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAul8a34+mPCNJttXCSauR0bmHAtBQNOp4cPMDz8nPinAiB3h5A8Th/DBOtsUnVQzfSz8SUV5UEET7qD6IiGkBh4jQ=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@heliyos%2fheliyos-mcp@1.0.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":588763},"main":"dist/src/index.js","name":"@heliyos/heliyos-mcp","type":"module","types":"dist/src/index.d.ts","author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"engines":{"node":">=20"},"exports":{".":{"types":"./dist/src/index.d.ts","import":"./dist/src/index.js"}},"gitHead":"908bc308633426e1bf09b59a17dcfb4e0e867bbd","license":"MIT","mcpName":"ai.heliyos/heliyos-mcp","scripts":{"test":"vitest run","build":"npm run clean && npm run codegen && tsc -p tsconfig.json","clean":"node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"","smoke":"HELIYOS_MCP_SMOKE=1 vitest run tests/smoke.live.test.ts","codegen":"node scripts/codegen.mjs","typecheck":"tsc -p tsconfig.test.json","readme:tools":"npm run build && node scripts/tool-table.mjs","sync-openapi":"node scripts/sync-openapi.mjs","install-links":"node scripts/cursor-link.mjs","prepublishOnly":"npm run prepublish:check && npm run build && npm test","prepublish:check":"node scripts/prepublish-check.mjs","test:update-tool-snapshot":"UPDATE_TOOL_SNAPSHOT=1 vitest run tests/toolList.snapshot.test.ts"},"version":"1.0.5","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"2fc6965a-f299-4346-a7b2-c172e3a64a71"}},"homepage":"https://docs.heliyos.ai/mcp/overview","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","directories":{},"maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"_nodeVersion":"22.23.4","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/server":"^2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","msw":"^2.15.0","vitest":"^2.1.9","typescript":"~5.9.3","@types/node":"^22.20.5","ajv-formats":"^3.0.1","@modelcontextprotocol/client":"^2.3.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/heliyos-mcp_1.0.5_1793987249930_0.6634630630069719"}}},"time":{"created":"2026-11-06T15:39:44.622Z","modified":"2026-11-06T17:47:30.334Z","0.0.0-stage":"2026-11-06T15:39:44.622Z","1.0.0":"2026-11-06T15:42:53.378Z","1.0.1":"2026-11-06T16:01:21.065Z","1.0.2":"2026-11-06T16:27:33.010Z","1.0.3":"2026-11-06T16:42:46.293Z","1.0.4":"2026-11-06T17:43:53.351Z","1.0.5":"2026-11-06T17:47:30.021Z"},"bugs":{"url":"https://github.com/heliyos-ai/heliyos-mcp/issues"},"author":{"url":"https://www.heliyos.ai","name":"Heliyos"},"license":"MIT","homepage":"https://docs.heliyos.ai/mcp/overview","keywords":["mcp","mcp-server","model-context-protocol","heliyos","crm","sales","revenue","gtm","ai-agents","ai-workers","customer-memory","agent-tools","stdio"],"repository":{"url":"git+https://github.com/heliyos-ai/heliyos-mcp.git","type":"git"},"description":"Model Context Protocol server for Heliyos, the AI operating system for revenue. Gives AI agents tools for customer records, notes, tasks, email and meeting history, Scouts and signals, reviews, workers and the knowledge base, over stdio with a workspace A","maintainers":[{"name":"rcsiit1","email":"rajan@heliyos.ai"}],"readme":"
\n Connect AI agents to Heliyos, the AI operating system for revenue.\n
\n\n
\n \n \n \n \n \n
\n\n`@heliyos/heliyos-mcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server for [Heliyos](https://www.heliyos.ai). It runs on your machine over stdio and calls the [Heliyos API](https://docs.heliyos.ai/api-reference/introduction) with a workspace API key, so an agent in Claude Code, Codex, Cursor, VS Code, Antigravity or any other MCP client can work in your CRM.\n\n**Documentation: [docs.heliyos.ai/mcp](https://docs.heliyos.ai/mcp/overview)** · [Install guides](https://docs.heliyos.ai/mcp/install) · [All tools](https://docs.heliyos.ai/mcp/tools/index) · [API reference](https://docs.heliyos.ai/api-reference/introduction) · [Changelog](CHANGELOG.md)\n\nWith it, an agent can:\n\n- find and update companies, people, deals and custom objects, and add fields to them\n- read a record's timeline, change history, emails and meetings\n- write notes and tasks, and start Heliyos workers on a task\n- list the reviews waiting for a person and approve or reject them\n- create and configure workers from the trigger and tool catalogs\n- manage scouts, read their signals and keep the watchlist\n- read and edit the knowledge base, and upload the files the workers read\n- hand a job to Heliyos with `heliyos_ask` and follow the run\n\nImportant actions that workers take still wait for review in Heliyos, so the team stays in control.\n\n## Quick start\n\n1. Create an API key in Heliyos under **Settings → API keys** (details [below](#before-you-start)).\n2. Add the server to your client. For Claude Code:\n\n ```sh\n claude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos -- npx -y @heliyos/heliyos-mcp\n ```\n\n3. Ask your agent *\"Which Heliyos workspace am I connected to?\"*. It calls `heliyos_organization_get` and answers with your workspace name.\n\nEvery other client is covered in [Install](#install).\n\n## Contents\n\n- [Quick start](#quick-start)\n- [Before you start](#before-you-start)\n- [Install](#install)\n- [Tool timeout](#tool-timeout)\n- [Configuration](#configuration)\n- [Tools](#tools)\n- [Security](#security)\n- [Troubleshooting](#troubleshooting)\n- [Development](#development)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Before you start\n\nYou need Node.js 20 or later (`node -v`) and a Heliyos API key.\n\nTo create a key:\n\n1. Open Heliyos and go to **Settings → API keys** ([gtm.heliyos.ai/settings/api-keys](https://gtm.heliyos.ai/settings/api-keys)).\n2. Click **New key**. Give it a name you will recognise, such as \"Claude Code on my laptop\", and an expiry date if you want one, then click **Create key**.\n3. Copy the key. It starts with `heliyos_` and is shown once. If you lose it, revoke it and create a new one.\n\nOnly workspace owners and admins can create keys. A key has admin access to one workspace, the one you created it in, and to nothing else. Use one key per person and machine, so you can revoke one without breaking the others.\n\n## Install\n\nEvery client runs the same command, `npx -y @heliyos/heliyos-mcp`, with your key in the `HELIYOS_API_KEY` environment variable. In the snippets below, replace `YOUR_HELIYOS_API_KEY` with your key.\n\n### Claude Code\n\nInstall the plugin and set your key in one go. The key goes into your system's secure credential store, never into a file, and the plugin adds a skill that teaches Claude when to use which tool.\n\n```sh\nclaude plugin marketplace add heliyos-ai/heliyos-mcp\nclaude plugin install heliyos@heliyos --config api_key=YOUR_HELIYOS_API_KEY\n```\n\nIf you installed without `--config`, the server stays off until the key is set: run `/plugin configure heliyos@heliyos` inside Claude Code and enter it there. Then `/mcp` lists `heliyos`, or restart Claude Code if it does not.\n\nOr add only the MCP server:\n\n```sh\nclaude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos -- npx -y @heliyos/heliyos-mcp\n```\n\nCheck it with `claude mcp list`, or `/mcp` inside a session.\n\n### Claude Desktop\n\nOpen **Settings → Developer → Edit Config** and add the server to `claude_desktop_config.json`, then restart Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"heliyos\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/heliyos-mcp\"],\n \"env\": { \"HELIYOS_API_KEY\": \"YOUR_HELIYOS_API_KEY\" }\n }\n }\n}\n```\n\nThis file stores the key in plain text, so keep it private. Custom connectors on claude.ai and in the Claude connector directory need a hosted (remote) MCP server with OAuth. Heliyos does not offer one yet, so use a local client for now.\n\n### Codex\n\nAdd the server to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.heliyos]\ncommand = \"npx\"\nargs = [\"-y\", \"@heliyos/heliyos-mcp\"]\nenv_vars = [\"HELIYOS_API_KEY\"]\nstartup_timeout_sec = 30\ntool_timeout_sec = 120\n```\n\n`env_vars` passes `HELIYOS_API_KEY` from the shell you start Codex in, so export it there (for example in `~/.zshrc`). To keep the key in the file instead, replace the `env_vars` line with an env table at the end:\n\n```toml\n[mcp_servers.heliyos.env]\nHELIYOS_API_KEY = \"YOUR_HELIYOS_API_KEY\"\n```\n\nThe CLI does the same in one line, after which you add `tool_timeout_sec = 120` to the table it writes:\n\n```sh\ncodex mcp add heliyos --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY -- npx -y @heliyos/heliyos-mcp\n```\n\n### Cursor\n\n[Add Heliyos to Cursor](https://cursor.com/install-mcp?name=heliyos&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBoZWxpeW9zL2hlbGl5b3MtbWNwIl0sImVudiI6eyJIRUxJWU9TX0FQSV9LRVkiOiIke2VudjpIRUxJWU9TX0FQSV9LRVl9In19)\n\nThe link opens this deeplink, which you can also paste into your browser:\n\n```text\ncursor://anysphere.cursor-deeplink/mcp/install?name=heliyos&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBoZWxpeW9zL2hlbGl5b3MtbWNwIl0sImVudiI6eyJIRUxJWU9TX0FQSV9LRVkiOiIke2VudjpIRUxJWU9TX0FQSV9LRVl9In19\n```\n\nIt adds this entry to `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"heliyos\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/heliyos-mcp\"],\n \"env\": { \"HELIYOS_API_KEY\": \"${env:HELIYOS_API_KEY}\" }\n }\n }\n}\n```\n\nCursor reads `${env:HELIYOS_API_KEY}` from its own environment. Export the variable in your shell profile and start Cursor from that shell, or replace the value with your key. Run `npm run install-links` in this repository to print the links again.\n\n### VS Code\n\n[Install Heliyos in VS Code](https://vscode.dev/redirect/mcp/install?name=heliyos&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22heliyos-api-key%22%2C%22description%22%3A%22Heliyos+API+key+%28Settings+%E2%86%92+API+keys%29%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40heliyos%2Fheliyos-mcp%22%5D%2C%22env%22%3A%7B%22HELIYOS_API_KEY%22%3A%22%24%7Binput%3Aheliyos-api-key%7D%22%7D%7D)\n\nThe link opens this deeplink, which you can also paste into your browser:\n\n```text\nvscode:mcp/install?%7B%22name%22%3A%22heliyos%22%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22heliyos-api-key%22%2C%22description%22%3A%22Heliyos%20API%20key%20(Settings%20%E2%86%92%20API%20keys)%22%2C%22password%22%3Atrue%7D%5D%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40heliyos%2Fheliyos-mcp%22%5D%2C%22env%22%3A%7B%22HELIYOS_API_KEY%22%3A%22%24%7Binput%3Aheliyos-api-key%7D%22%7D%7D)%22%2C%22password%22%3Atrue%7D%5D%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40heliyos%2Fmcp%22%5D%2C%22env%22%3A%7B%22HELIYOS_API_KEY%22%3A%22%24%7Binput%3Aheliyos-api-key%7D%22%7D%7D\n```\n\nVS Code asks for the key the first time the server starts and keeps it in its secret storage. To set it up by hand, add this to `.vscode/mcp.json` in a project, or to your user `mcp.json` (**MCP: Open User Configuration**):\n\n```json\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"heliyos-api-key\",\n \"description\": \"Heliyos API key (Settings → API keys)\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"heliyos\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/heliyos-mcp\"],\n \"env\": { \"HELIYOS_API_KEY\": \"${input:heliyos-api-key}\" }\n }\n }\n}\n```\n\n### Antigravity\n\nIn the agent panel, open **… → MCP Servers → Manage MCP Servers → View raw config**, or edit `~/.gemini/config/mcp_config.json` directly (`.agents/mcp_config.json` for one project):\n\n```json\n{\n \"mcpServers\": {\n \"heliyos\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@heliyos/heliyos-mcp\"],\n \"env\": { \"HELIYOS_API_KEY\": \"YOUR_HELIYOS_API_KEY\" }\n }\n }\n}\n```\n\n### Any other client\n\nRun the package over stdio with the key in the environment:\n\n```sh\nHELIYOS_API_KEY=YOUR_HELIYOS_API_KEY npx -y @heliyos/heliyos-mcp\n```\n\nThe repository also ships portable [Agent Plugins](https://agent-plugins.org) manifests (`plugin.json` and `mcp.json`) for clients that install plugins from a Git repository. They do not carry a key, so set `HELIYOS_API_KEY` in the environment your client starts servers with. In the MCP Registry the server is listed as `ai.heliyos/heliyos-mcp`.\n\n## Tool timeout\n\n`heliyos_ask` waits up to 90 seconds for Heliyos to answer, so give tool calls at least 120 seconds.\n\n| Client | Setting |\n| --- | --- |\n| Codex | `tool_timeout_sec = 120` in the `[mcp_servers.heliyos]` table (the default is 60). Installed as a plugin from a marketplace, Codex keeps the 60 second default, because the plugin's `.mcp.json` cannot carry `tool_timeout_sec`, so a long `heliyos_ask` stops at 60 seconds; use the `config.toml` setup above for 120. |\n| Claude Code | The default is long enough. If you set `MCP_TOOL_TIMEOUT`, keep it at 120000 or more, for example `MCP_TOOL_TIMEOUT=120000 claude`. |\n| Claude Desktop | No documented setting. |\n| Cursor | No documented tool timeout setting. |\n| VS Code | No documented tool timeout setting. |\n| Antigravity | No documented tool timeout setting. |\n\nWhen a client cuts a call short, the run keeps going in Heliyos. Find it with `heliyos_runs_list` and follow it with `heliyos_runs_get` and `wait: true`, which waits up to 30 seconds per call.\n\nA rate-limited request (HTTP 429) is retried once after the `Retry-After` delay, capped at 30 s, so a `heliyos_ask` that hits the limit can take about 125 seconds. If you see timeouts while you are near the limit, raise the timeout to 150 seconds.\n\n## Configuration\n\n| Variable | Required | Default | What it does |\n| --- | --- | --- | --- |\n| `HELIYOS_API_KEY` | Yes | None | Your Heliyos API key. It must start with `heliyos_`. |\n| `HELIYOS_BASE_URL` | No | `https://api-prod.heliyos.ai` | The Heliyos API to call. It must use https; plain http is accepted only for localhost. |\n| `HELIYOS_MCP_EXPERIMENTAL` | No | Off | `1`, `true`, `yes` or `on` adds the experimental tools marked below. |\n\nThe server also offers a resource template, `heliyos://records/{id}`, which returns one record as JSON, and two prompts: `prepare_account_review` (for one company) and `daily_pipeline_summary`.\n\n## Tools\n\nEvery tool is named `heliyos__` and declares whether it reads, writes or deletes, so your client can ask before it changes anything. Reads take `response_format` (`concise` or `detailed`), and lists take `limit` and `cursor`.\n\n\n73 tools by default, and 4 more with `HELIYOS_MCP_EXPERIMENTAL=1`. Kind is read (no changes), write (creates or updates) or destructive (deletes or removes).\n\n#### Records\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_records_list` | List records | read |\n| `heliyos_records_get` | Get a record | read |\n| `heliyos_records_create` | Create a record | write |\n| `heliyos_records_update` | Update a record | write |\n| `heliyos_records_delete` | Delete records | destructive |\n| `heliyos_records_lookup` | Find records by name | read |\n| `heliyos_records_enrich` | Enrich a person (experimental) | write |\n\n#### Timeline and activity\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_records_timeline` | Read a record's timeline | read |\n| `heliyos_records_events` | Read a record's change history | read |\n| `heliyos_interactions_list` | List emails and meetings | read |\n| `heliyos_interactions_get` | Get an email or meeting | read |\n\n#### Workspace, objects and fields\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_organization_get` | Get the workspace | read |\n| `heliyos_objects_list` | List objects | read |\n| `heliyos_objects_get` | Get an object's fields | read |\n| `heliyos_objects_create` | Create a custom object (experimental) | write |\n| `heliyos_objects_update` | Rename or describe an object (experimental) | write |\n| `heliyos_objects_delete` | Delete a custom object (experimental) | destructive |\n| `heliyos_fields_create` | Add a field to an object | write |\n| `heliyos_fields_update` | Change a field | destructive |\n| `heliyos_fields_delete` | Delete a field | destructive |\n\n#### Notes\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_notes_list` | List notes | read |\n| `heliyos_notes_get` | Get a note | read |\n| `heliyos_notes_create` | Create a note | write |\n| `heliyos_notes_update` | Update a note | write |\n| `heliyos_notes_delete` | Delete a note | destructive |\n\n#### Tasks\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_tasks_list` | List tasks | read |\n| `heliyos_tasks_get` | Get a task | read |\n| `heliyos_tasks_events` | Read a task's activity | read |\n| `heliyos_tasks_create` | Create a task | write |\n| `heliyos_tasks_update` | Update a task | write |\n| `heliyos_tasks_delete` | Delete a task | destructive |\n| `heliyos_tasks_run` | Run workers on a task | destructive |\n\n#### Scouts and signals\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_scouts_list` | List scouts | read |\n| `heliyos_scouts_get` | Get a scout | read |\n| `heliyos_scouts_create` | Create a scout | write |\n| `heliyos_scouts_update` | Update a scout | write |\n| `heliyos_scouts_delete` | Delete a scout | destructive |\n| `heliyos_companies_scouts_list` | List a company's scouts | read |\n| `heliyos_companies_scouts_add` | Add scouts to a company | write |\n| `heliyos_companies_scouts_remove` | Remove a company's scouts | destructive |\n| `heliyos_signals_list` | List signals | read |\n| `heliyos_signals_mark_read` | Mark signals read | write |\n\n#### Ask, runs and reviews\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_ask` | Ask Heliyos | destructive |\n| `heliyos_runs_get` | Get a run | read |\n| `heliyos_runs_list` | List runs | read |\n| `heliyos_reviews_list` | List reviews | read |\n| `heliyos_reviews_get` | Get a review | read |\n| `heliyos_reviews_decide` | Approve or reject a review | destructive |\n\n#### Workers, triggers and tools\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_workers_list` | List workers | read |\n| `heliyos_workers_get` | Get a worker | read |\n| `heliyos_workers_create` | Create a worker | write |\n| `heliyos_workers_update` | Update a worker | write |\n| `heliyos_workers_delete` | Delete a worker | destructive |\n| `heliyos_triggers_list` | List worker triggers | read |\n| `heliyos_workers_tools_list` | List tools a worker can use | read |\n\n#### Knowledge base and files\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_knowledge_get` | Read the knowledge base | read |\n| `heliyos_knowledge_update` | Update the knowledge base | write |\n| `heliyos_knowledge_entries_set` | Add or change a knowledge entry | write |\n| `heliyos_knowledge_entries_delete` | Delete a knowledge entry | destructive |\n| `heliyos_files_list` | List files | read |\n| `heliyos_files_get` | Get a file | read |\n| `heliyos_files_upload` | Upload a file | write |\n| `heliyos_files_delete` | Delete a file | destructive |\n\n#### Watchlist\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_watchlist_get` | Get the watchlist | read |\n| `heliyos_companies_watch` | Watch a company | write |\n| `heliyos_companies_unwatch` | Unwatch a company | destructive |\n\n#### Labels\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_labels_list` | List label groups | read |\n| `heliyos_labels_create` | Create a label group | write |\n| `heliyos_labels_update` | Update a label group | destructive |\n| `heliyos_labels_delete` | Delete a label group | destructive |\n\n#### Team\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_team_members_list` | List team members | read |\n| `heliyos_team_members_invite` | Invite a team member | write |\n| `heliyos_team_members_remove` | Remove a team member | destructive |\n| `heliyos_team_members_change_role` | Change a team member's role | write |\n\n#### Notification settings\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_notification_settings_get` | Get notification settings | read |\n| `heliyos_notification_settings_update` | Update notification settings | write |\n\n#### Usage\n\n| Tool | What it does | Kind |\n| --- | --- | --- |\n| `heliyos_usage_get` | Get credit usage | read |\n\n\n## Security\n\n- **Your key stays on your machine.** The server reads it from its environment and sends it only to the Heliyos API (`HELIYOS_BASE_URL`), as a bearer token over https. It refuses a base URL that is not https, other than localhost.\n- **File uploads skip the key.** File content goes to a short-lived signed storage URL, and that request does not carry your key.\n- **No telemetry.** The server sends nothing anywhere else and keeps no logs. Diagnostics go to your client's stderr, and error messages have keys removed.\n- **Rate limits.** The API allows 60 requests per minute per key, and per IP address. When it answers 429, the server waits for `Retry-After` and retries once.\n- **Least access.** A key has admin rights in one workspace. Give it an expiry, keep one key per person and machine, and revoke it in **Settings → API keys** when you no longer need it.\n- **Destructive tools are marked.** Deletes and removals are annotated as destructive, and the agent skill tells agents to confirm them first.\n\nReport a security issue privately through [GitHub security advisories](https://github.com/heliyos-ai/heliyos-mcp/security/advisories/new) rather than in a public issue.\n\n## Troubleshooting\n\n| What you see | What to do |\n| --- | --- |\n| `heliyos-mcp: Set HELIYOS_API_KEY to a Heliyos API key` | The client did not pass the key. Check the `env` block, or that the variable is exported in the shell that started the client. |\n| `HELIYOS_API_KEY does not look like a Heliyos API key` | The value is not a Heliyos key. Keys start with `heliyos_`. Copy it again or create a new one. |\n| `UNAUTHENTICATED` | The key was revoked, has expired or was mistyped. Create a new key in **Settings → API keys**. |\n| `FORBIDDEN_ACTION` | The workspace plan or billing status does not allow the action, or the action is not available to API keys. |\n| `RATE_LIMITED` | You are above 60 requests per minute. Wait a minute, and prefer list calls over many single gets. |\n| `heliyos_ask` times out | Raise the client's tool timeout (see [Tool timeout](#tool-timeout)). The run keeps going; follow it with `heliyos_runs_get`. |\n| The server shows \"connecting\" on its first start | The first `npx -y @heliyos/heliyos-mcp` downloads the package, which can take 20 to 30 seconds on a slow connection and outlast a client's startup timeout. Warm the cache once from a terminal with `npx -y @heliyos/heliyos-mcp --version`, then reconnect; later starts take about a second. Or raise the timeout (Codex `startup_timeout_sec`, Claude Code `MCP_TIMEOUT=60000`). |\n| `Node 16.x is too old` or tools fail with `fetch is not defined` | The client started `npx` with an old Node, usually a version manager's default. The server needs Node 20 or newer and restarts itself on the newest suitable Node it finds (nvm, fnm, n, Volta, Homebrew, PATH); the message names which one. If it finds none, install Node 20+ or run `nvm install 20 && nvm alias default 20`, then restart the client. Apps opened from the dock may not find `npx` at all; use its full path from `which npx`. |\n| Experimental tools are missing | Set `HELIYOS_MCP_EXPERIMENTAL=1` and restart the client. |\n\nStill stuck? Open an issue at [github.com/heliyos-ai/heliyos-mcp/issues](https://github.com/heliyos-ai/heliyos-mcp/issues). Never paste your key.\n\n## Development\n\nRequirements: Node.js 20 or later and npm. Everything else is a dev dependency.\n\n```sh\ngit clone https://github.com/heliyos-ai/heliyos-mcp.git\ncd heliyos-mcp\nnpm ci\nnpm test # unit tests with a mocked Heliyos API\nnpm run typecheck\nnpm run build # codegen, then tsc into dist/\nnpm run readme:tools # regenerate the tool table above\nnpm run install-links # print the Cursor and VS Code install links\nnpm run prepublish:check # manifests, versions and package contents\nHELIYOS_API_KEY=YOUR_HELIYOS_API_KEY npm run smoke # read-only checks against a real workspace\n```\n\nTo run your local build in a client instead of the published package, point the client at `dist/src/bin/stdio.js`:\n\n```sh\nclaude mcp add --transport stdio --env HELIYOS_API_KEY=YOUR_HELIYOS_API_KEY --scope user heliyos-dev -- node /path/to/heliyos-mcp/dist/src/bin/stdio.js\n```\n\n### How it is built\n\n- `src/client/openapi/` holds copies of the Heliyos API's OpenAPI documents. `npm run codegen` turns them into a typed operation table (`src/client/generated.ts`) with zod schemas, so every request is validated before it is sent.\n- `src/tools/` defines one file per resource. Each tool declares its input and output schemas, its annotations (read, write or destructive) and a handler that calls one or two API operations and renders a short text plus `structuredContent`.\n- `tests/` runs every tool against a mocked API with msw. A snapshot test pins the public tool contract (names, annotations, input keys), so an accidental change fails the build.\n- `skills/heliyos/SKILL.md` ships with the Claude Code plugin and teaches the agent when to use which tool.\n\n### Updating the API client\n\nWhen the Heliyos API changes, save the new OpenAPI documents and resync:\n\n```sh\ncurl -s https://api-prod.heliyos.ai/v1/platform/openapi.json -o /tmp/platform.json\ncurl -s https://api-prod.heliyos.ai/v1/auth/openapi.json -o /tmp/auth.json\nHELIYOS_PLATFORM_OPENAPI=/tmp/platform.json HELIYOS_AUTH_OPENAPI=/tmp/auth.json npm run sync-openapi\nnpm run codegen && npm test\n```\n\nWith those two variables set, `npm run prepublish:check` and the drift test also refuse a bundled copy that no longer matches.\n\n### Releasing\n\nReleases are published by GitHub Actions on every push to `main` (`.github/workflows/publish-package.yml`):\n\n1. CI builds, tests and checks the package and manifests.\n2. If the version in `package.json` is already on npm, the workflow bumps the patch version with `node scripts/set-version.mjs`, which keeps `package.json`, the lockfile, `server.json`, every plugin manifest and `src/version.ts` on the same version, and commits the bump.\n3. It publishes to npm with provenance through npm trusted publishing (no token is stored anywhere), waits until the version is served, and then publishes `server.json` to the MCP registry when the `MCP_PRIVATE_KEY` secret is configured.\n\nTo cut a specific version, run `node scripts/set-version.mjs 1.2.0`, commit, and push to `main`. See [CONTRIBUTING.md](CONTRIBUTING.md) for the one-time repository setup.\n\n## Contributing\n\nIssues and pull requests are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow, the coding rules and how to add a tool, and [SECURITY.md](SECURITY.md) for how to report a vulnerability. By participating you agree to the [code of conduct](CODE_OF_CONDUCT.md).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}
![\"Heliyos\"](\"https://raw.githubusercontent.com/heliyos-ai/heliyos-mcp/main/assets/logo-dark.png\"){kind=logo}
\n ![\"npm](\"https://img.shields.io/npm/v/%40heliyos%2Fmcp?label=npm\")
![\"CI\"](\"https://github.com/heliyos-ai/heliyos-mcp/actions/workflows/test.yml/badge.svg\"){kind=icon}
\n ![\"Node](\"https://img.shields.io/badge/node-%3E%3D20-brightgreen\"){kind=icon}
![\"MIT](\"https://img.shields.io/badge/license-MIT-blue\"){kind=icon}
![\"MCP\"](\"https://img.shields.io/badge/protocol-MCP-black\"){kind=icon}