Zendesk API MCP Server

Implementation Reference

• src/tools/help-center.js:38-52 (handler)

  Handler function for the 'get_article' MCP tool. Fetches the Zendesk Help Center article by ID using zendeskClient and returns a formatted text response or error.

  handler: async ({ id }) => {
    try {
      const result = await zendeskClient.getArticle(id);
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify(result, null, 2)
        }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error getting article: ${error.message}` }],
        isError: true
      };
    }

• src/tools/help-center.js:35-37 (schema)

  Zod input schema for the 'get_article' tool, requiring a numeric 'id' parameter.

  schema: {
    id: z.number().describe("Article ID")
  },

• src/server.js:48-52 (registration)

  Registers the 'get_article' tool with the MCP server via server.tool(), using the name, schema, handler, and description from the tool definition.

  allTools.forEach((tool) => {
    server.tool(tool.name, tool.schema, tool.handler, {
      description: tool.description,
    });
  });

• src/zendesk-client.js:259-260 (helper)

  ZendeskClient helper method that performs the API GET request to retrieve a specific Help Center article by ID.

  async getArticle(id) {
    return this.request("GET", `/help_center/articles/${id}.json`);