Zendesk Knowledge MCP
Read-only access to Zendesk knowledge sources: searches Help Center articles and retrieves full articles with plan requirements and dates, searches and fetches developer.zendesk.com API and developer documentation, merges changelogs, announcements, and release notes, checks live status for active incidents and scheduled maintenance, and determines whether a feature is current, beta, EAP, deprecated, or retired.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Zendesk Knowledge MCP is the Zendesk messaging API deprecated?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zendesk Knowledge MCP
Read-only MCP server for Zendesk docs, status, and changelogs.
Host | Content |
| Help Center articles, announcements, release notes, what's new |
| API reference, developer docs, developer changelog |
| Active incidents, scheduled maintenance |
Other hosts are refused. Redirects are re-checked.
Install
Needs Node.js 20+. No API keys.
Claude Code (server plus the zendesk-knowledge skill):
/plugin marketplace add Nightious-Tools/zendesk-knowledge-mcp
/plugin install zendesk-knowledge-mcp@zendesk-knowledge-mcpCodex:
codex plugin marketplace add Nightious-Tools/zendesk-knowledge-mcpThen run /plugins, install Zendesk Knowledge, and start a new session.
Other MCP clients:
{
"mcpServers": {
"zendesk-knowledge": {
"command": "npx",
"args": ["-y", "github:Nightious-Tools/zendesk-knowledge-mcp"]
}
}
}On Windows, some clients need "command": "cmd", "args": ["/c", "npx", "-y", "github:Nightious-Tools/zendesk-knowledge-mcp"].
Server only:
claude mcp add zendesk-knowledge -s user -- npx -y github:Nightious-Tools/zendesk-knowledge-mcp
codex mcp add zendesk-knowledge -- npx -y github:Nightious-Tools/zendesk-knowledge-mcpRelated MCP server: Context7 Private Docs MCP
Tools
Tool | Purpose |
| Search Help Center articles. Paginated. |
| Full article with headings, plan requirements and dates. |
| Find developer.zendesk.com pages. |
| Full developer page with headings. |
| Changelog, announcements, and release notes merged. |
| Active incidents and upcoming maintenance. |
| Is a feature current, beta, EAP, deprecated, or retired. |
Each tool returns JSON with ok, tool, data, citations, notes, and, when relevant, conflicts and pagination. Errors return ok: false with error.code: DOMAIN_NOT_ALLOWED, HTTP_ERROR, TIMEOUT, NOT_FOUND, RESTRICTED, BAD_INPUT, or INTERNAL.
Environment variables
All optional. See .env.example.
Variable | Default |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Development
git clone https://github.com/Nightious-Tools/zendesk-knowledge-mcp && cd zendesk-knowledge-mcp
npm install
npm test
npm run build # writes dist/index.mjs, which is committed
npm run inspect # MCP InspectorLicense
Source-available, not open source. You may install and run it; you may not redistribute or modify it. See LICENSE.
Available Tools
7 toolsget_developer_pageGet Zendesk developer docs pageARead-onlyIdempotent
Fetch and clean one developer.zendesk.com page (API reference, guide, changelog). Returns markdown-ish text, headings, badges (e.g. Deprecated) and lifecycle classification.
Inputs: url (required).
get_feature_lifecycleCheck a Zendesk feature's lifecycle statusARead-onlyIdempotent
Composite lookup for questions like 'Is offset pagination deprecated?' or 'Is Copilot GA?'. Searches canonical Help Center docs, developer docs, and the change feeds, then returns a consolidated verdict (current/future/beta/eap/deprecated/legacy/retired) with the preferred source and any conflicting sources.
Inputs: feature (required), locale.
get_help_articleGet Zendesk Help Center articleARead-onlyIdempotent
Fetch one official Help Center article by numeric id or support.zendesk.com URL. Returns cleaned full text (truncated if very long), plan banners, breadcrumbs, dates and lifecycle classification.
Inputs: article_id_or_url (required), locale.
get_zendesk_changesGet Zendesk changes (changelog, release notes, announcements)ARead-onlyIdempotent
What changed and when: merges the official developer changelog (developer.zendesk.com) with the 'Zendesk updates' feeds on support.zendesk.com (Announcements, Developer updates, Release notes, What's new). Each item carries change_type (breaking_change, deprecated, removed, new, update, beta, eap, release_notes, announcement), dates and lifecycle.
Inputs: feeds, limit, query, since, +1 more.
get_zendesk_statusGet Zendesk system statusARead-onlyIdempotent
Live active incidents and upcoming maintenance from the official Zendesk Status API (status.zendesk.com), optionally filtered to a subdomain. Historical/resolved incidents are not exposed by Zendesk's API.
Inputs: subdomain.
search_developer_docsSearch Zendesk developer docsARead-onlyIdempotent
Search developer.zendesk.com (API reference, apps framework, SDKs). Ranks pages from the official sitemap by URL slug, then fetches the top pages live for title, snippet and deprecation badges. Use endpoint/resource names as they appear in URLs (e.g. 'ticket audits', 'webhooks', 'custom objects', 'oauth tokens').
Inputs: query (required), section, fetch_pages, max_results.
search_help_centerSearch Zendesk Help CenterARead-onlyIdempotent
Search official Zendesk product documentation on support.zendesk.com via the Help Center Search API (articles only; community posts are excluded). Returns title, snippet, canonical URL, updated date, product, plan requirements and lifecycle status for each hit. Paginated.
Inputs: query (required), page, locale, product, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clearly distinct targets (status API, changelog feeds, help center search/fetch, developer docs search/fetch). However, get_feature_lifecycle overlaps conceptually with search_help_center, search_developer_docs, and get_zendesk_changes since it aggregates the same sources, and get_developer_page vs search_developer_docs could occasionally be confused by an agent deciding whether to fetch or search.
All seven tools follow a clean verb_noun pattern with get_* and search_* prefixes (get_developer_page, get_zendesk_changes, get_zendesk_status, get_feature_lifecycle, search_help_center, get_help_article, search_developer_docs). The convention is predictable and readable throughout.
Seven tools is well-scoped for a read-only documentation/knowledge server. Each tool earns its place (search vs fetch for each doc source, plus changes, status, and lifecycle aggregation) with no redundant filler.
The surface covers the core domain well: search and fetch for both Help Center and developer docs, plus changelog, status, and lifecycle verdicts. Minor gaps exist (e.g., no community post search by design, no bulk listing of feeds), but agents can work around these.
Maintenance
Related MCP Connectors
Read-only access to Communicate developer guides, OpenAPI summaries, and support contact.
Provides access to Google's public developer documentation.
Search and read the undocsend docs, pricing and security pages. Public, read-only, no sign-in.
31Read-only search over the Vocenya AI receptionist API docs and endpoints, with code samples.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to browse, search, and fetch documentation from any public Zendesk Help Center via a read-only API.9MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying private documentation with tools for version resolution, stale reference checking, and receipt export.MIT
- AlicenseNot gradedqualityBmaintenanceEnables read-only access to generated technical documentation across one or multiple documented repositories, exposing tools to search code and docs, inspect modules and symbols, list gaps, review architecture, and check freshness with file#line citations.MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to search official AWS documentation, read pages as clean markdown-style text in slices, and get related page recommendations without an AWS account or API key.87 npmMIT