Rollbar MCP Server

Instructions

Implementation Reference

• src/rollbar.ts:375-391 (handler)

  The switch case handler that destructures the 'uuid' argument from the tool call, checks for projectClient availability, makes a GET request to Rollbar API endpoint `/item/${uuid}` to fetch the item, and returns the response data as text content.

  case "rollbar_get_item_by_occurrence_uuid": {
    // Project Token is required
    if (!projectClient) {
      throw new Error("ROLLBAR_PROJECT_TOKEN is not set, cannot use this API");
    }
  
    const { uuid } = args as { uuid: string };
    const response = await projectClient.get<ItemResponse>(`/item/${uuid}`);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response.data, null, 2),
        },
      ],
    };
  }

• src/rollbar.ts:153-164 (schema)

  Tool schema definition including name, description, and inputSchema that requires a 'uuid' string parameter.

  const GET_ITEM_BY_UUID_TOOL: Tool = {
    name: "rollbar_get_item_by_occurrence_uuid",
    description:
      "Get a specific item (error) from Rollbar using an occurrence UUID. The UUID must be from an occurrence that belongs to the item.",
    inputSchema: {
      type: "object",
      properties: {
        uuid: { type: "string", description: "Occurrence UUID" },
      },
      required: ["uuid"],
    },
  };

• src/rollbar.ts:298-314 (registration)

  Registers the tool by including GET_ITEM_BY_UUID_TOOL in the array of tools returned by the ListToolsRequestSchema handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      LIST_ITEMS_TOOL,
      GET_ITEM_TOOL,
      GET_ITEM_BY_UUID_TOOL,
      GET_ITEM_BY_COUNTER_TOOL,
      LIST_OCCURRENCES_TOOL,
      GET_OCCURRENCE_TOOL,
      LIST_PROJECTS_TOOL,
      GET_PROJECT_TOOL,
      LIST_ENVIRONMENTS_TOOL,
      LIST_USERS_TOOL,
      GET_USER_TOOL,
      LIST_DEPLOYS_TOOL,
      GET_DEPLOY_TOOL,
    ],
  }));