Infracost MCP Server

Instructions

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: [],
    },
  },