Skip to main content
Glama

Zendesk Knowledge MCP

Read-only MCP server for Zendesk docs, status, and changelogs.

Host

Content

support.zendesk.com

Help Center articles, announcements, release notes, what's new

developer.zendesk.com

API reference, developer docs, developer changelog

status.zendesk.com

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-mcp

Codex:

codex plugin marketplace add Nightious-Tools/zendesk-knowledge-mcp

Then 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-mcp

Related MCP server: Context7 Private Docs MCP

Tools

Tool

Purpose

search_help_center(query, locale?, product?, page?, per_page?)

Search Help Center articles. Paginated.

get_help_article(article_id_or_url, locale?, heading?)

Full article with headings, plan requirements and dates. heading returns one section.

search_developer_docs(query, max_results?, section?, fetch_pages?)

Find developer.zendesk.com pages.

get_developer_page(url, heading?)

Full developer page with headings. heading or a URL #anchor returns one section.

get_zendesk_changes(query?, since?, locale?, limit?, feeds?)

Changelog, announcements, and release notes merged.

get_zendesk_status(subdomain?)

Active incidents and upcoming maintenance.

get_feature_lifecycle(feature, locale?)

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

ZD_USER_AGENT

zendesk-knowledge-mcp/1.0 (+https://github.com/Nightious-Tools/zendesk-knowledge-mcp)

ZD_DEFAULT_LOCALE

en-us

ZD_HTTP_TIMEOUT_MS

15000

ZD_HTTP_MAX_RETRIES

2

ZD_RATE_{SUPPORT,DEVELOPER,STATUS}_PER_MIN

60 / 60 / 10 (status max 10)

ZD_CACHE_TTL_{SEARCH,PAGE,STATUS,SITEMAP}_S

300 / 900 / 60 / 3600

ZD_CACHE_MAX_ENTRIES

500 (in-memory)

ZD_MAX_CONTENT_CHARS

12000

ZD_LOG_LEVEL

info (silent, error, info, debug; stderr)

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 Inspector

License

Source-available, not open source. You may install and run it; you may not redistribute or modify it. See LICENSE.

Available Tools

7 tools
get_developer_pageGet Zendesk developer docs pageA
Read-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 statusA
Read-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 articleA
Read-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)A
Read-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 statusA
Read-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 docsA
Read-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 CenterA
Read-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

    A4/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      MIT