infracost_cloud_list_guardrails
Retrieve all cost guardrails configured in Infracost Cloud to monitor and control cloud spending across your infrastructure.
Instructions
List all guardrails in Infracost Cloud. Requires INFRACOST_SERVICE_TOKEN environment variable.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orgSlug | No | Organization slug from Infracost Cloud (defaults to INFRACOST_ORG env var) |
Implementation Reference
- src/tools.ts:639-663 (handler)Handler method in InfracostTools class that validates input with ListGuardrailsSchema, checks config, calls cloudApiClient.listGuardrails, and returns the formatted result.
async handleListGuardrails(args: z.infer<typeof ListGuardrailsSchema>) { if (!this.cloudApiClient) { throw new Error('INFRACOST_SERVICE_TOKEN is not configured for Infracost Cloud API operations'); } const orgSlug = args.orgSlug || this.config.orgSlug; if (!orgSlug) { throw new Error('Organization slug is required. Provide it via orgSlug parameter or set INFRACOST_ORG environment variable'); } const result = await this.cloudApiClient.listGuardrails(orgSlug); if (!result.success) { throw new Error(result.error || 'List guardrails request failed'); } return { content: [ { type: 'text', text: result.output || 'Guardrails retrieved successfully', }, ], }; } - src/api.ts:210-240 (helper)Core API helper method that performs the GET request to Infracost Cloud API to list guardrails for the organization.
async listGuardrails(orgSlug: string): Promise<CommandResult> { try { const response = await fetch(`${INFRACOST_CLOUD_API_BASE}/orgs/${orgSlug}/guardrails`, { method: 'GET', headers: { Authorization: `Bearer ${this.serviceToken}`, }, }); if (!response.ok) { const errorText = await response.text(); return { success: false, error: `API request failed with status ${response.status}: ${errorText}`, }; } const data = (await response.json()) as GuardrailList; return { success: true, output: JSON.stringify(data, null, 2), data, }; } catch (error) { return { success: false, error: error instanceof Error ? error.message : 'Unknown error occurred', }; } } - src/tools.ts:214-216 (schema)Zod schema for input validation of the tool, defining optional orgSlug parameter.
export const ListGuardrailsSchema = z.object({ orgSlug: z.string().optional().describe('Organization slug from Infracost Cloud (defaults to INFRACOST_ORG env var)'), }); - src/index.ts:487-501 (registration)Tool registration in the MCP server's listTools response, including name, description, and input schema.
{ name: 'infracost_cloud_list_guardrails', description: 'List all guardrails in Infracost Cloud. Requires INFRACOST_SERVICE_TOKEN environment variable.', inputSchema: { type: 'object', properties: { orgSlug: { type: 'string', description: 'Organization slug from Infracost Cloud (defaults to INFRACOST_ORG env var)', }, }, required: [], }, },