Zendesk API MCP Server

Implementation Reference

• src/tools/views.js:72-93 (handler)

  The handler function that executes the 'create_view' tool logic. It constructs the view data from inputs and calls the Zendesk client to create the view, returning formatted success or error content.

  handler: async ({ title, description, conditions }) => {
    try {
      const viewData = {
        title,
        description,
        conditions
      };
      
      const result = await zendeskClient.createView(viewData);
      return {
        content: [{ 
          type: "text", 
          text: `View created successfully!\n\n${JSON.stringify(result, null, 2)}`
        }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error creating view: ${error.message}` }],
        isError: true
      };
    }
  }

• src/tools/views.js:56-71 (schema)

  The Zod schema defining the input parameters for the 'create_view' tool: title (required string), description (optional string), conditions (object with all/any filter arrays).

  schema: {
    title: z.string().describe("View title"),
    description: z.string().optional().describe("View description"),
    conditions: z.object({
      all: z.array(z.object({
        field: z.string().describe("Field to filter on"),
        operator: z.string().describe("Operator for comparison"),
        value: z.any().describe("Value to compare against")
      })).optional(),
      any: z.array(z.object({
        field: z.string().describe("Field to filter on"),
        operator: z.string().describe("Operator for comparison"),
        value: z.any().describe("Value to compare against")
      })).optional()
    }).describe("Conditions for the view")
  },

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

  The registration code in the MCP server that dynamically registers the 'create_view' tool (included in viewsTools) by calling server.tool with its name, schema, handler, and description.

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

• src/zendesk-client.js:195-197 (helper)

  Helper method in ZendeskClient that makes the POST API request to /views.json to create a new view using the provided data.

  async createView(data) {
    return this.request("POST", "/views.json", { view: data });
  }

• src/server.js:37-37 (registration)

  Inclusion of viewsTools (containing create_view) into the allTools array for registration.

  ...viewsTools,