{"_id":"@enterpret/zendesk-mcp-server","_rev":"11-d2b75297964eca3763fde874f772b6fc","name":"@enterpret/zendesk-mcp-server","dist-tags":{"latest":"0.4.1"},"versions":{"0.1.0":{"name":"@enterpret/zendesk-mcp-server","version":"0.1.0","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.1.0","maintainers":[{"name":"ishitamundhra","email":"ishita@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"1395f5ddf7eefe29960eda52b86f82803777034f","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.1.0.tgz","fileCount":6,"integrity":"sha512-ZL1xGj+h2BokM9d1utIn6WqyTafLzLCtS+P1fPHl69TmPHoLgJKSKdqFrm9oy/hD3zLHIZn4kZNwK1sB8frLKA==","signatures":[{"sig":"MEQCIFmdUjdcX18M2+FOTMz0WFBVy2sVQZkRMVznVuJrwidJAiAjOMArgh2ClSEm3HvO7db1s6NGmtLqRy0xwm0vLPnOJw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":235776},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"3529f19f05f36d549c700393906205ca82b226bd","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"ishitamundhra","email":"ishita@enterpret.com"},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.9.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.1.0_1780351132102_0.27417306697725086","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@enterpret/zendesk-mcp-server","version":"0.2.0","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.2.0","maintainers":[{"name":"ishitamundhra","email":"ishita@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"e471b8f22e735b5f1e04807d1628bab649c0c58c","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.2.0.tgz","fileCount":6,"integrity":"sha512-t2R7qtPiaUbK9NlEHImXifKQ77eKrE0LMMXx80Qg33s3T8E2M/zFBGkEI0CVsxjWMOQoT1BKSMMlLTfhKUYI9Q==","signatures":[{"sig":"MEUCIDVU8vCVYzKDIGYmD1FPbEfvxem7lrXt4QKb2RgwRcn4AiEAweGQldg6Fm72nrYpGNQFV7OMQ5hJ1npHHuqAc2eNjpw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":235776},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"19cf2d6b8916b5347045e06db265a7861621a2c2","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"ishitamundhra","email":"ishita@enterpret.com"},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.9.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.2.0_1780397206410_0.1682487210006962","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@enterpret/zendesk-mcp-server","version":"0.3.0","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.3.0","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"592b1160398e0bc257f8cf3ea5514496c01f5e98","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.3.0.tgz","fileCount":6,"integrity":"sha512-Lxvu6htWXNDVZJah2qqxVk6RzZoYQxmPCVL5ejIHSxhLEjfmX2gLS4Y5vUwMVIgUQi0nM+KH6M3R4jLb8WWaHg==","signatures":[{"sig":"MEUCIQDFczWoSoC/vci04ZHUR1sbL674juZbi7OJT6M6aQSrfgIgE34DRyFkIKdiiu4tJfrjruZ90UoNdEcRe+nL3VVsg+A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC3bKsRn6DagITzQ7XFKLP5KdDNYQdZ0jG2DDEtykwGpwIhAJmj9k1m/FQJzitkLh5tu2NyzYHRDI2Qws9i11NNfG0W","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":268849},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"3be82b39b5f1ce1fdddd38d534f9ee0780542bde","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"61cee43a-d717-403e-9830-1b5467322f1b"}},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.20.0","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.3.0_1790692120608_0.557699713128736","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@enterpret/zendesk-mcp-server","version":"0.3.1","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.3.1","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"},{"name":"amand33p_s","email":"amandeep@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"681b29c1a288c2a8b54895e99db1de66f592bf65","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.3.1.tgz","fileCount":6,"integrity":"sha512-JcDvqjD43E1AMlVp0rJK098G4yU7VQwJ4dn98cStcQFWZdGB3DlJjaa+LlcTkdzRWFbiO4XxjzNnARSHH6wUyw==","signatures":[{"sig":"MEQCIC9TihHmE9HUwBJlIQkFdSA4eM4N7hwPAuRiB1cofUK0AiBr1sJ06VKARw1+vfnslbzeWGHIyLnY2Wb84KHRxwy25A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDqyNtOt1P0bz3lSvjTtRI9+7LPtxK4zyDzKO8dCNYY6QIhAPpCgIdowwQ/SKbPGmsPkcXEs2IEs6JCtmhRleRWXpOx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":268625},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"94c407c307a6673a2189f784f13f1e17614adeef","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"61cee43a-d717-403e-9830-1b5467322f1b"}},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.20.0","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.3.1_1790710837265_0.828694294017666","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@enterpret/zendesk-mcp-server","version":"0.3.2","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.3.2","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"},{"name":"amand33p_s","email":"amandeep@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"1aa1ada616add7690e5847ab98b709f2746578ee","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.3.2.tgz","fileCount":6,"integrity":"sha512-Yc99MQM6kx8RL53n+RBb6A5vPxekIzPFOec2u03iFZUxoAnQLO4Ajl3wls7lpwD8BVSfvce9V95uY1pfAXh4Kw==","signatures":[{"sig":"MEYCIQCrj8yOgP1O2/py3dQXoFpOM8ArbRvI9Ae/1LdROc0n6gIhAOXd/dL/HaokzF1vaSkYp5jLqTljMH1SK53chVhV2bHS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBOQb5daA8Kc+vw7ZLweMpgXha9dX+ZyXjEmRCZnHwwpAiAfaBLKyt+/u8E0PiQ+D04SL3CDp+7PxyxnVR18IyhFLw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270611},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"72e006e111565d991c8197c5dc001011e91d94b8","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"61cee43a-d717-403e-9830-1b5467322f1b"}},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.20.0","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.3.2_1790717713819_0.729298715503711","host":"s3://npm-registry-packages-npm-production"}},"0.3.3":{"name":"@enterpret/zendesk-mcp-server","version":"0.3.3","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.3.3","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"},{"name":"amand33p_s","email":"amandeep@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"4f8def95ea9debd37de6c6bde0c4c72b0e7c0155","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.3.3.tgz","fileCount":6,"integrity":"sha512-shFBLiFfUAH3YEBonLaYCl+unxhkfzRYvGhKTqb2iMzImE4uEmv68g2Ie2BKrl4W0sH0Yc+cT/iIyYEel5qKQQ==","signatures":[{"sig":"MEYCIQChZOuJqm+oGvNjXbmU22fsIzGHiIBnuL4gujNoBvsIEAIhAKMOHK7ZhCaCwOolGc6ybA04eNeY2OMGl6bnVQ3NAMJL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICOifyZyOkp8TTx/M7NILkSLfn2Bn5NcUVeT/nzFbcPmAiEAot5QGubt/6RpTanx8KhTMzDgT2MEcaiTIrKjAXJqwc4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270956},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"0de2dfef9c285589349ebff9dddfa7ad295a1231","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"61cee43a-d717-403e-9830-1b5467322f1b"}},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.21.0","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.3.3_1790793768668_0.23877006290128988","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@enterpret/zendesk-mcp-server","version":"0.4.0","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","_id":"@enterpret/zendesk-mcp-server@0.4.0","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"},{"name":"amand33p_s","email":"amandeep@enterpret.com"}],"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"bin":{"zendesk-mcp-server":"dist/index.js"},"dist":{"shasum":"7ce51f1796caac9623980ecd497ace3aeffdb581","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.4.0.tgz","fileCount":6,"integrity":"sha512-IM48VfmBX/Uw41kWyzDW+88+iDkAgMj6GAkCFEWE7t98fBhxHeBsOTN4wZ1WVEeaqVxZxs+HdaaoVkMkDM+EGg==","signatures":[{"sig":"MEYCIQCcpawV7T6RmaI8RPnPy6fgQ0sxjBnSoM7K1w9VAG2zSwIhALca8DlVvnzlOz/mvZ7N7BQlnzM0e+6U0kgUFyRI/zFl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCr26ILQ+3fXdrMsg+r5/UIoaYr9o1toTveFuOqzjeuJgIgFpZMKkQIATeNEKIzCWBjeP82b2CjzQZgDVGh/Afrkzk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":274310},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"gitHead":"01cc637ca65db2dce3dfd1e7bae074bb53b72a3a","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"61cee43a-d717-403e-9830-1b5467322f1b"}},"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.21.1","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"tmp":"tmp/zendesk-mcp-server_0.4.0_1792683554660_0.8037234156604043","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"_id":"@enterpret/zendesk-mcp-server@0.4.1","bin":{"zendesk-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"dist":{"shasum":"76b29e98461eb7ed90fcfe7a5954feb2bef0e8e0","tarball":"https://registry.npmjs.org/@enterpret/zendesk-mcp-server/-/zendesk-mcp-server-0.4.1.tgz","fileCount":6,"integrity":"sha512-YYBzxGL0txz5NmkgLIGGg4FhKCOCNzFL6OtjI845yvjvXE8SwzWgfByFAQaRAuM2ET6DtiphzeKGXOH2IJhEXQ==","signatures":[{"sig":"MEQCID+gTPHSLbnax7s4sZPuIBW1Kmg8VWfQgJaFqUZBoN9JAiAmgGB0AqDf4lsc+kDZT3yHh3n/tTVPMSMUlboJunXugg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFA6zoU3dCaWNkK+JZPNCjg+tYic4TvM+O6OjEhm6A3zAiEAnF5EOXuNTBYF3RdXojzrmFJe0X32/fBdTLvYJGO2k2Q="}],"unpackedSize":274891},"main":"dist/index.js","name":"@enterpret/zendesk-mcp-server","type":"module","types":"dist/index.d.ts","author":{"name":"Digital4Better","email":"hello@digital4better.com"},"engines":{"node":">=20"},"gitHead":"093a690a9ddda8a2ab3d8d5fe172467beae2c2d9","license":"MIT","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsdown","check":"biome check src/","start":"node dist/index.js","prepare":"npm run build","check:fix":"biome check --write src/","typecheck":"tsc --noEmit","test:smoke":"pnpm build && node scripts/smoke-test.mjs","test:watch":"vitest watch","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"version":"0.4.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"61cee43a-d717-403e-9830-1b5467322f1b"}},"homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"_npmVersion":"11.21.1","description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","directories":{},"maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"},{"name":"amand33p_s","email":"amandeep@enterpret.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"4.4.3","open":"11.0.0","cheerio":"1.2.0","unified":"11.0.5","rehype-raw":"7.0.0","remark-gfm":"4.0.1","rehype-parse":"9.0.1","remark-parse":"11.0.0","rehype-remark":"10.0.1","remark-rehype":"11.1.2","rehype-stringify":"10.0.1","remark-stringify":"11.0.0","hast-util-to-html":"9.0.5","hast-util-to-mdast":"10.1.2","@modelcontextprotocol/sdk":"1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215","devDependencies":{"msw":"^2.12.13","shx":"^0.4.0","tsx":"^4.21.0","tsdown":"^0.22.0","vitest":"^4.1.0","typescript":"^6.0.3","@types/hast":"^3.0.4","@types/node":"^22.15.0","@biomejs/biome":"^2.4.7","@tsconfig/node20":"^20.1.9","semantic-release":"^25.0.3","@tsconfig/strictest":"^2.0.8","@vitest/coverage-v8":"^4.1.0","@semantic-release/git":"^10.0.1","@semantic-release/npm":"^13.1.5","@semantic-release/github":"^12.0.6","@semantic-release/changelog":"^6.0.3","@semantic-release/release-notes-generator":"^14.1.1","conventional-changelog-conventionalcommits":"^9.3.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zendesk-mcp-server_0.4.1_1793002103693_0.7068628827888976"}}},"time":{"created":"2026-06-01T21:58:51.994Z","modified":"2026-10-26T08:08:24.229Z","0.1.0":"2026-06-01T21:58:52.253Z","0.2.0":"2026-06-02T10:46:46.574Z","0.3.0":"2026-09-29T14:28:40.702Z","0.3.1":"2026-09-29T19:40:37.352Z","0.3.2":"2026-09-29T21:35:13.937Z","0.3.3":"2026-09-30T18:42:48.776Z","0.4.0":"2026-10-22T15:39:14.757Z","0.4.1":"2026-10-26T08:08:23.783Z"},"bugs":{"url":"https://github.com/aavaz-ai/zendesk-mcp-server/issues"},"author":{"name":"Digital4Better","email":"hello@digital4better.com"},"license":"MIT","homepage":"https://github.com/aavaz-ai/zendesk-mcp-server#readme","keywords":["mcp","zendesk","help-center","modelcontextprotocol","ai","claude"],"repository":{"url":"git+https://github.com/aavaz-ai/zendesk-mcp-server.git","type":"git"},"description":"MCP server for Zendesk Support & Help Center APIs. Forked from @fruggr/zendesk-mcp-server; adds ZENDESK_OAUTH_BEARER env mode for headless broker-supplied OAuth tokens.","maintainers":[{"name":"shwetankshrey","email":"shwetank@enterpret.com"},{"name":"ishitamundhra","email":"ishita@enterpret.com"},{"name":"eternaltangent","email":"tanay@enterpret.com"},{"name":"amand33p_s","email":"amandeep@enterpret.com"}],"readme":"# @enterpret/zendesk-mcp-server\n\n> Fork of [`@fruggr/zendesk-mcp-server`](https://github.com/fruggr/zendesk-mcp-server) (MIT).\n> Adds one feature: a `ZENDESK_OAUTH_BEARER` env mode for headless setups\n> where an external OAuth broker (e.g. Nango) hands the access token\n> directly to the subprocess.\n>\n> All credit for the underlying server design + tool surface goes to\n> [Digital4Better](https://digital4better.com).\n\n---\n\n# Zendesk MCP Server\n\n[![npm](https://img.shields.io/npm/v/@fruggr/zendesk-mcp-server)](https://www.npmjs.com/package/@fruggr/zendesk-mcp-server)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that connects LLMs to the **Zendesk Support & Help Center APIs** — with per-user OAuth 2.1 PKCE authentication and fine-grained tool visibility controls.\n\n## Why this server?\n\nMost Zendesk integrations use a shared admin API key, giving every user full access to every ticket. This server takes a different approach:\n\n- **Per-user authentication** — Each user authenticates with their own Zendesk credentials via OAuth 2.1 PKCE. No shared admin key, no elevated privileges. The LLM sees exactly what the user is allowed to see.\n- **Context-friendly tool modes** — Expose 38 individual tools, 3 namespace proxies, or a single unified tool. Choose the mode that fits your LLM's context budget.\n- **Section-based article editing** — For large Help Center articles, read and rewrite one section at a time (parsed by h1/h2/h3 headings) instead of shuffling the full HTML body through the LLM. Reduces tokens by 10–100× on targeted edits.\n- **Read-only mode** — Restrict the server to read operations only, ideal for assistants that should never modify data.\n- **Zero runtime dependencies beyond the MCP SDK** — Built on `@modelcontextprotocol/sdk` and `zod`. No Express, no heavyweight frameworks.\n\n> Built and maintained by [Digital4better](https://digital4better.com) for the [Fruggr](https://www.fruggr.io) project.\n\n## Tool modes\n\nThe server registers tools in one of three modes, controlled by `--mode`:\n\n| Mode | Tools exposed | Best for |\n|------|--------------|----------|\n| **`all`** | 38 individual tools (`get_ticket`, `search_articles`, ...) | Clients with good tool selection, full granularity |\n| **`namespace`** (default) | 3 proxy tools (`zendesk_tickets`, `zendesk_help_center`, `zendesk_users`) | Balanced context usage, grouped operations |\n| **`single`** | 1 proxy tool (`zendesk`) | Minimal context footprint, single entry point |\n\nIn `namespace` and `single` modes, the proxy tool accepts `{ \"operation\": \"<tool_name>\", \"params\": { ... } }` and dispatches to the appropriate handler after validating params through the original Zod schema. Proxy descriptions include only the first sentence of each sub-operation to stay compact; the full schema is applied when the operation is actually called.\n\n> **Tip:** The `single` mode is particularly useful for models with limited tool slots — one tool handles all 38 operations.\n\n### Scoping the surface\n\n`--namespace` and `--read-only` apply to every mode (including the default `namespace` mode) — they filter tools **before** the proxies are built, so the description of each proxy reflects only the operations that survive the filters. Combine them to register a focused surface:\n\n```bash\n# Only the Help Center proxy, only read-only operations\nzendesk-mcp-server acme --namespace help_center --read-only\n\n# Only the Tickets proxy (read + write)\nzendesk-mcp-server acme --namespace tickets\n```\n\n`--namespace` is repeatable. `--tool` is also available for cherry-picking individual operations but forces `--mode all`.\n\n## Available tools\n\n<details>\n<summary><strong>Tickets</strong> (10 tools)</summary>\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `get_ticket` | Retrieve a ticket by ID with optional comments | read |\n| `get_ticket_attachments` | Download ticket attachments (images as base64, others as references) | read |\n| `search_tickets` | Search account tickets; optional `brand_id` filter | read |\n| `list_tickets` | List authorized account tickets across brands with cursor pagination | read |\n| `get_linked_incidents` | Get incidents linked to a problem ticket | read |\n| `create_ticket` | Create a ticket; optional `brand_id` assigns its brand | write |\n| `update_ticket` | Update ticket fields; optional `brand_id` explicitly changes its brand | write |\n| `add_private_note` | Add an internal note (not visible to requester) | write |\n| `add_public_comment` | Add a public comment (visible to requester) | write |\n| `manage_tags` | Add or remove tags on a ticket | write |\n\n</details>\n\n<details>\n<summary><strong>Help Center</strong> (22 tools)</summary>\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `list_brands` | Discover account brands, IDs, and Help Center subdomains with cursor pagination | read |\n| `search_articles` | Search authorized articles across brands, including restricted articles; optional `brand_id` filter | read |\n| `get_article` | Retrieve authorized article with full HTML body; `brand_id` selects another Help Center | read |\n| `get_article_outline` | Compact outline of an article (sections + available translations) | read |\n| `get_article_section` | Retrieve a single section (html or markdown); omitted `locale` uses the article source locale | read |\n| `list_categories` | List all Help Center categories | read |\n| `list_sections` | List sections, optionally filtered by category | read |\n| `list_articles` | List articles with sorting and translation info | read |\n| `list_article_translations` | List available translations for an article | read |\n| `list_article_attachments` | List attachments on an article | read |\n| `list_permission_groups` | List account-wide Guide permission groups (needed to create articles) | read |\n| `list_content_tags` | List account-wide Guide content tags (end-user visible) | read |\n| `list_labels` | List article labels (search ranking, not user-visible) | read |\n| `list_user_segments` | List account-wide user segments (article visibility) | read |\n| `compare_translations` | Section-level diff between two locales of an article | read |\n| `create_article` | Create an article in a section; optional `brand_id` selects its Help Center | write |\n| `update_article` | Update article metadata; optional `brand_id` selects its Help Center | write |\n| `create_article_translation` | Create a translation; optional `brand_id` selects its Help Center | write |\n| `update_article_translation` | Update a translation (full body); optional `brand_id` selects its Help Center | write |\n| `update_article_section` | Replace one article section; optional `brand_id` selects its Help Center | write |\n| `create_content_tag` | Create an account-wide Guide content tag | write |\n| `create_article_attachment` | Upload an article attachment; optional `brand_id` selects its Help Center | write |\n\n</details>\n\n### Private/restricted Help Center articles\n\nHelp Center reads use the connected user's Zendesk permissions, including\nrestricted articles that user can access. No additional OAuth scope is needed\nbeyond `read`; reconnecting does not change the user's Guide permissions.\n\nHelp Centers are brand-specific. `search_articles` searches across authorized\nbrands by default (`multibrand: true`). Use `multibrand: false` to search only\nthe installed brand, or `brand_id` to search one specific brand. Search results\ninclude article URLs so you can identify their Help Center.\n\nFor an article or section on another brand, call `list_brands`, match its\nsubdomain or custom domain to the article URL, and pass that `brand_id` to subsequent reads and writes.\nThe connector resolves the brand through the authenticated account before\nsending the same token to its Zendesk subdomain; callers cannot supply an\narbitrary host. Re-send `brand_id` on each paginated request.\nAll numeric Zendesk resource IDs (fields ending in `_id`, plus attachment IDs and\ncustom-field IDs) accept either a positive safe integer or\nits decimal string representation. The connector converts decimal strings to\nnumbers before calling Zendesk and rejects other strings. This does not change\nwhich resources the connected user can access. String-valued content-tag IDs,\nsection indexes, and pagination parameters keep their existing input types.\n`list_brands` accepts `page_size` and the `cursor` returned by its previous\nresponse; it does not use the article-search `page`/`per_page` parameters.\n\n```json\n{\"operation\":\"search_articles\",\"params\":{\"query\":\"internal SOP\"}}\n{\"operation\":\"list_brands\",\"params\":{}}\n{\"operation\":\"get_article\",\"params\":{\"article_id\":\"5100\",\"brand_id\":\"42\"}}\n{\"operation\":\"list_articles\",\"params\":{\"section_id\":600,\"brand_id\":42}}\n```\n\nAll brand-specific Help Center reads **and writes** support `brand_id`. It\nselects the target Help Center, not a field written into an article or translation.\nOmitting it preserves installed-subdomain behavior (except article search,\nwhich searches all authorized brands by default). Writes require the connected\nuser's existing edit permissions and a write-capable token. Zendesk permission\nerrors are returned directly; brand selection does not grant additional access.\n\n### Brand scope across every tool\n\nThe connection subdomain identifies the account for authentication; it is not\nan account-wide brand restriction. Account-level calls stay on that host and\nuse Zendesk's native account permissions. They are not repeated across brands.\n`list_brands` belongs to `help_center` in every mode. When using namespace\nfilters, include both `--namespace tickets --namespace help_center` to make\nbrand discovery available alongside ticket operations. Without filters,\nall modes expose it (`zendesk_help_center` in `namespace` mode).\n\n| Tools | Brand behavior |\n|-------|----------------|\n| `get_article`, `get_article_outline`, `get_article_section`, `list_categories`, `list_sections`, `list_articles`, `list_article_translations`, `list_article_attachments`, `list_labels`, `compare_translations` | Optional `brand_id` selects the Help Center host; use the same brand on every related read and pagination request |\n| `create_article`, `update_article`, `create_article_translation`, `update_article_translation`, `update_article_section`, `create_article_attachment` | Same optional `brand_id` routing, including preparatory reads; no automatic retries or writes to other brands |\n| `search_articles` | Native multibrand search by default; optional `brand_id` narrows to one brand and takes precedence over `multibrand` |\n| `search_tickets` | Account-wide search by default; optional `brand_id` adds a `brand:<id>` ticket search filter. Use either `brand_id` or `brand:` query filters, not both |\n| `create_ticket`, `update_ticket` | Account host; optional `brand_id` assigns/changes the ticket's brand via the ticket payload. Omitted: Zendesk's default creation behavior / preserves the existing brand on update |\n| `get_ticket`, `get_ticket_attachments`, `list_tickets`, `get_linked_incidents`, `add_private_note`, `add_public_comment`, `manage_tags` | Account-level ticket IDs/listing; no brand routing needed. Notes, comments, and tags do not change a ticket's brand |\n| `get_current_user`, `search_users`, `get_user`, `get_organization`, `list_organizations`, `search` | Account-wide users/organizations and unified search. Use `type:ticket brand:<id>` in unified search to filter tickets, not shared users/organizations |\n| `list_brands`, `list_permission_groups`, `list_content_tags`, `create_content_tag`, `list_user_segments` | Account-wide discovery/shared configuration; no Help Center brand selection needed |\n\nTicket reads and search results show `brand_id` when Zendesk supplies it.\nAll tools reject unknown parameters, including a misspelled `brandId`.\nAccount-wide operations without a `brand_id` parameter reject an unsupported\nbrand filter rather than silently ignoring it. Use `search_tickets` for\nbrand-filtered ticket listing.\n\nFor protected ticket image URLs on another Zendesk brand, the connector\nresolves the ticket's `brand_id` through the account Brands API before sending\ncredentials to that exact HTTPS origin. Historical ticket brands may be\ninactive and do not need a Help Center. Operations routed to a brand's Help\nCenter still require an active brand with a Help Center; article search uses\nZendesk's account-level search filters. Unrelated attachment origins receive\nno credentials. If the ticket/brand lookup fails, foreign image URLs are\nattempted without credentials, so public images remain available and\nprotected images still require authorization. Failed downloads\nremain text references, as before. The ticket/brand lookup is reused within\nthat attachment call, not cached across users or calls.\nWhen supplying `attachment_ids`, use IDs from the specified `ticket_id`;\nthe existing direct-ID lookup does not verify ticket membership. A mismatched\nbrand host is not authenticated with the selected ticket's credentials.\n\nAPI contracts: [Help Center search](https://developer.zendesk.com/api-reference/help_center/help-center-api/help_center_search/),\n[article visibility](https://developer.zendesk.com/api-reference/help_center/help-center-api/articles/),\nand [account brands](https://developer.zendesk.com/api-reference/ticketing/account-configuration/brands/).\nAccount-level contracts: [tickets](https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/),\n[ticket brand search](https://support.zendesk.com/hc/en-us/articles/4408886879258-Zendesk-Support-search-reference),\n[permission groups](https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/),\n[shared user segments](https://support.zendesk.com/hc/en-us/articles/4408837707290-Creating-user-segments-for-help-center-user-permissions),\nand [shared content tags](https://support.zendesk.com/hc/en-us/articles/4848925672730-About-content-tags).\n\n<details>\n<summary><strong>Users & Organizations</strong> (5 tools)</summary>\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `get_current_user` | Get the authenticated user (verify identity) | read |\n| `search_users` | Search users by name, email, or query syntax | read |\n| `get_user` | Retrieve a user by ID | read |\n| `get_organization` | Retrieve an organization by ID | read |\n| `list_organizations` | List all organizations with pagination | read |\n\n</details>\n\n<details>\n<summary><strong>Search</strong> (1 tool)</summary>\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `search` | Unified search across tickets, users, and organizations | read |\n\n</details>\n\n## Prerequisites\n\n- **Node.js** >= 20 (runtime — declared in `package.json#engines.node`)\n- A **Zendesk** instance (Support or Suite)\n\n> Contributors and maintainers run the toolchain on a newer Node + pnpm —\n> see [Development](#development).\n\n## Installation\n\n```bash\n# Run without installing\nnpx -y @fruggr/zendesk-mcp-server <your-subdomain>\n```\n\nOr install globally:\n\n```bash\nnpm install -g @fruggr/zendesk-mcp-server\nzendesk-mcp-server <your-subdomain>\n```\n\nOr clone and run locally:\n\n```bash\ngit clone https://github.com/fruggr/zendesk-mcp-server.git\ncd zendesk-mcp-server\npnpm install\npnpm build\nnode dist/index.js <your-subdomain>\n```\n\nOr run a development branch directly from GitHub (handy for testing PRs without publishing to npm) — the `prepare` script builds the package automatically on install:\n\n```bash\n# Latest main\nnpx -y github:fruggr/zendesk-mcp-server <your-subdomain>\n\n# A specific branch / tag / commit\nnpx -y github:fruggr/zendesk-mcp-server#my-feature-branch <your-subdomain>\n```\n\n## Authentication\n\nThe server supports two authentication methods:\n\n### Option A: OAuth 2.1 PKCE (recommended)\n\nNo API key needed. Each user authenticates via their browser on the first tool call.\n\n**Zendesk setup:**\n\n1. Go to **Admin Center > Apps and integrations > APIs > OAuth Clients**\n2. Create a public client:\n   - **Identifier**: `<your-subdomain>_zendesk` (or set `ZENDESK_OAUTH_CLIENT_ID`)\n   - **Redirect URL**: `http://localhost:3000/callback`\n\n**Run:**\n\n```bash\nzendesk-mcp-server <your-subdomain>\n```\n\nOn the first tool call, a browser window opens for the user to authenticate. The token is cached in memory for the session.\n\n### Option B: API token\n\nFor headless/CI environments or quick testing.\n\n**Zendesk setup:**\n\n1. Go to **Admin Center > Apps and integrations > APIs > Zendesk API**\n2. Enable **Token Access**, create a token\n\n**Run:**\n\n```bash\nZENDESK_EMAIL=you@example.com ZENDESK_API_TOKEN=dneib123... \\\n  zendesk-mcp-server <your-subdomain>\n```\n\n## Configuration\n\n### MCP client configuration\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"zendesk\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@fruggr/zendesk-mcp-server\", \"<your-subdomain>\", \"--mode\", \"single\"],\n      \"env\": {\n        \"ZENDESK_EMAIL\": \"you@example.com\",\n        \"ZENDESK_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>Claude Code</strong></summary>\n\n```bash\nclaude mcp add zendesk -- npx -y @fruggr/zendesk-mcp-server <your-subdomain> --mode single\n```\n\nFor API token auth, set the env vars before launching Claude Code or add them to your shell profile.\n\n</details>\n\n<details>\n<summary><strong>VS Code (Copilot / Continue / Cline)</strong></summary>\n\nAdd to your `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"zendesk\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@fruggr/zendesk-mcp-server\", \"<your-subdomain>\", \"--mode\", \"single\"],\n      \"env\": {\n        \"ZENDESK_EMAIL\": \"you@example.com\",\n        \"ZENDESK_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n### CLI reference\n\n```\nzendesk-mcp-server <subdomain> [options]\n\nOptions:\n  --mode <mode>           single | namespace (default) | all\n  --namespace <ns>        Filter by namespace (repeatable): tickets, help_center, users\n  --tool <name>           Filter by tool name (repeatable, forces --mode all)\n  --read-only             Only expose read operations\n  --log-level <level>     debug | info (default) | warn | error\n```\n\n`--namespace` and `--read-only` are applied before the proxies are registered, so they narrow the surface in every mode — in the default `namespace` mode, `--namespace help_center` registers a single proxy (`zendesk_help_center`) instead of three.\n\n**Examples:**\n\n```bash\n# Single tool mode — minimal context, all 38 operations in one tool\nzendesk-mcp-server acme --mode single\n\n# Read-only tickets only\nzendesk-mcp-server acme --read-only --namespace tickets\n\n# Cherry-pick specific tools\nzendesk-mcp-server acme --tool get_ticket --tool search_tickets --tool get_current_user\n```\n\n### Environment variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ZENDESK_SUBDOMAIN` | yes (or CLI arg) | — | Zendesk subdomain (e.g., `acme` for acme.zendesk.com) |\n| `ZENDESK_OAUTH_CLIENT_ID` | no | `<subdomain>_zendesk` | OAuth client identifier |\n| `ZENDESK_EMAIL` | for API token auth | — | Agent email for Basic auth |\n| `ZENDESK_API_TOKEN` | for API token auth | — | Zendesk API token |\n| `LOG_LEVEL` | no | `info` | Log verbosity |\n\nIf both `ZENDESK_EMAIL` and `ZENDESK_API_TOKEN` are set, the server uses API token auth. Otherwise, it uses OAuth 2.1 PKCE.\n\n## Development\n\n### Toolchain\n\n| Tool | Version | Source of truth |\n| ---- | ------- | ---------------- |\n| Node | 24 | [`.nvmrc`](.nvmrc) — read by `nvm`, `fnm`, `mise`, `asdf`, `volta` |\n| pnpm | 11 | [`package.json#packageManager`](package.json) (pinned with a corepack integrity hash) |\n\nThe toolchain (Node 24 + pnpm 11) is used to build, lint, type-check and\ntest the project. The **published package** still runs on Node 20+ (see\n`engines.node`); a dedicated CI job installs the packed tarball on Node 20\nand runs the smoke test to keep that promise honest.\n\n```bash\n# Install dependencies\npnpm install\n\n# Dev mode (auto-reload)\nZENDESK_EMAIL=you@example.com ZENDESK_API_TOKEN=xxx \\\n  pnpm dev -- <your-subdomain> --mode all\n\n# Build\npnpm build\n\n# Type-check\npnpm typecheck\n\n# Lint\npnpm check\n\n# Tests\npnpm test\n```\n\n## Inspiration & related projects\n\nThis project was built with reference to:\n- The official [Zendesk API documentation](https://developer.zendesk.com/api-reference/)\n- [mattcoatsworth/zendesk-mcp-server](https://github.com/mattcoatsworth/zendesk-mcp-server)\n- [koundinya/zd-mcp-server](https://github.com/koundinya/zd-mcp-server)\n\n## Releases & versioning\n\nVersions follow [SemVer](https://semver.org/) and are calculated **automatically** from commit messages — no one bumps the version by hand. Every push to this fork's default branch, `master`, triggers [semantic-release](https://github.com/semantic-release/semantic-release), which inspects the new [Conventional Commits](https://www.conventionalcommits.org/) since the previous tag, computes the next version, updates [`CHANGELOG.md`](CHANGELOG.md), publishes `@enterpret/zendesk-mcp-server` to npm, and creates the matching GitHub Release. The one-time npm publisher and release-history prerequisites are in [release automation](docs/release-automation.md#fork-release-prerequisites).\n\n| Commit type | Resulting bump |\n|---|---|\n| `fix:`, `perf:` | patch |\n| `feat:` | minor |\n| `feat!:`, `fix!:`, or a `BREAKING CHANGE:` footer | major |\n| `docs:`, `chore:`, `refactor:`, `test:`, `ci:`, `style:`, `build:` | no release |\n\n## Contributing\n\nPull requests are welcome — including AI-assisted ones, as long as the human author has read and validated every line.\n\nThe full guide is in [`CONTRIBUTING.md`](CONTRIBUTING.md). The short version:\n\n1. Fork and create a feature branch from `master`.\n2. Practice TDD: write the failing test first, then implement.\n3. Use [Conventional Commits](https://www.conventionalcommits.org/) — they drive the next version bump via semantic-release.\n4. Make `pnpm check`, `pnpm typecheck`, and `pnpm test` pass locally.\n5. Run a Claude Code review on your diff before pushing.\n6. Open a PR.\n\nEvery PR is reviewed automatically by [CodeRabbit](https://www.coderabbit.ai) in CI, on top of the author-side AI review. The project is maintained in part with [Claude Code](https://www.anthropic.com/claude-code) assistance; that workflow is documented in [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}