infracost_cloud_delete_guardrail

Remove cost guardrails from Infracost Cloud to manage cloud spending policies and governance rules for Terraform infrastructure.

Instructions

Delete a guardrail from 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)
`guardrailId`	Yes	Guardrail ID to delete

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

Infracost MCP Server