rollbar_list_deploys
Retrieve deployment history from Rollbar to track releases, monitor environments, and analyze deployment status for error tracking projects.
Instructions
List deploys from Rollbar
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "rollbar_list_deploys"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | Project ID | |
| environment | No | Environment name | |
| limit | No | Maximum number of deploys to return (default: 20) | |
| page | No | Page number for pagination (default: 1) |
Implementation Reference
- src/rollbar.ts:569-608 (handler)Handler for the 'rollbar_list_deploys' tool. Validates project token, resolves effective project ID, constructs API parameters, calls Rollbar API to list deploys, and returns JSON response.
case "rollbar_list_deploys": { // Project Token is required if (!projectClient) { throw new Error("ROLLBAR_PROJECT_TOKEN is not set, cannot use this API"); } const { projectId, environment, limit = 20, page = 1, } = args as { projectId: number; environment?: string; limit?: number; page?: 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 params: Record<string, string | number> = { page, limit }; if (environment) params.environment = environment; const response = await projectClient.get<ListDeploysResponse>(`/project/${effectiveProjectId}/deploys`, { params, }); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; } - src/rollbar.ts:258-271 (schema)Schema definition for the 'rollbar_list_deploys' tool, specifying input parameters including required projectId and optional environment, limit, page.
const LIST_DEPLOYS_TOOL: Tool = { name: "rollbar_list_deploys", description: "List deploys from Rollbar", inputSchema: { type: "object", properties: { projectId: { type: "number", description: "Project ID" }, environment: { type: "string", description: "Environment name" }, limit: { type: "number", description: "Maximum number of deploys to return (default: 20)" }, page: { type: "number", description: "Page number for pagination (default: 1)" }, }, required: ["projectId"], }, }; - src/rollbar.ts:298-314 (registration)Registration of the 'rollbar_list_deploys' tool (as LIST_DEPLOYS_TOOL) in the ListTools response handler, making it available to clients.
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, ], }));