Infracost MCP Server

Instructions

Implementation Reference

• src/tools.ts:770-795 (handler)

  The primary MCP tool handler for 'infracost_cloud_delete_guardrail'. Validates input, resolves orgSlug from args or config, delegates to API client for deletion, handles errors, and returns formatted MCP response.

  async handleDeleteGuardrail(args: z.infer<typeof DeleteGuardrailSchema>) {
    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 { guardrailId } = args;
    const result = await this.cloudApiClient.deleteGuardrail(orgSlug, guardrailId);
  
    if (!result.success) {
      throw new Error(result.error || 'Delete guardrail request failed');
    }
  
    return {
      content: [
        {
          type: 'text',
          text: result.output || 'Guardrail deleted successfully',
        },
      ],
    };
  }

• src/tools.ts:270-273 (schema)

  Zod schema defining the input parameters for the tool: optional orgSlug and required guardrailId.

  export const DeleteGuardrailSchema = z.object({
    orgSlug: z.string().optional().describe('Organization slug from Infracost Cloud (defaults to INFRACOST_ORG env var)'),
    guardrailId: z.string().describe('Guardrail ID to delete'),
  });

• src/api.ts:355-385 (helper)

  Core implementation performing the HTTP DELETE request to the Infracost Cloud API endpoint `/orgs/{orgSlug}/guardrails/{guardrailId}` using the service token.

  async deleteGuardrail(orgSlug: string, guardrailId: string): Promise<CommandResult> {
    try {
      const response = await fetch(
        `${INFRACOST_CLOUD_API_BASE}/orgs/${orgSlug}/guardrails/${guardrailId}`,
        {
          method: 'DELETE',
          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}`,
        };
      }
  
      return {
        success: true,
        output: 'Guardrail deleted successfully',
      };
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : 'Unknown error occurred',
      };
    }
  }

• src/index.ts:657-675 (registration)

  Tool registration in the ListTools handler, including name, description, and input schema.

  {
    name: 'infracost_cloud_delete_guardrail',
    description:
      'Delete a guardrail from 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)',
        },
        guardrailId: {
          type: 'string',
          description: 'Guardrail ID to delete',
        },
      },
      required: ['guardrailId'],
    },
  },

• src/index.ts:774-777 (registration)

  Dispatch case in the CallToolRequest handler that parses args with schema and calls the tool handler.

  case 'infracost_cloud_delete_guardrail': {
    const validatedArgs = DeleteGuardrailSchema.parse(args);
    return await tools.handleDeleteGuardrail(validatedArgs);
  }