Rollbar MCP Server

Instructions

Implementation Reference

• src/rollbar.ts:506-532 (handler)

  Handler that resolves the effective project ID and fetches the list of environments from the Rollbar project API.

  case "rollbar_list_environments": {
    // Project Token is required
    if (!projectClient) {
      throw new Error("ROLLBAR_PROJECT_TOKEN is not set, cannot use this API");
    }
  
    const { projectId } = args as { projectId: number };
  
    // Use environment variable project ID as default value, or search by project name
    const effectiveProjectId = await getEffectiveProjectId(projectId);
  
    if (!effectiveProjectId) {
      throw new Error("Project ID is required but not provided in request or environment variables");
    }
  
    const response = await projectClient.get<ListEnvironmentsResponse>(
      `/project/${effectiveProjectId}/environments`,
    );
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response.data, null, 2),
        },
      ],
    };
  }

• src/rollbar.ts:225-235 (schema)

  Input schema for the tool, defining the required projectId parameter.

  const LIST_ENVIRONMENTS_TOOL: Tool = {
    name: "rollbar_list_environments",
    description: "List environments from Rollbar",
    inputSchema: {
      type: "object",
      properties: {
        projectId: { type: "number", description: "Project ID" },
      },
      required: ["projectId"],
    },
  };

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

  Tool registration in the ListToolsRequestSchema handler by including it in the returned tools list.

  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,
    ],
  }));

• src/types.ts:114-116 (schema)

  Response type definition for the list environments API call.

  export interface ListEnvironmentsResponse {
    environments: RollbarEnvironment[];
  }

• src/types.ts:15-18 (schema)

  Type definition for individual environment objects in the response.

  export interface RollbarEnvironment {
    id: number;
    name: string;
  }