RAD Security

Instructions

Implementation Reference

• src/operations/cloud-inventory.ts:67-76 (handler)

  The main handler function that executes the tool logic by making a specific API request to retrieve details for the given cloud resource.

  export async function getCloudResourceDetails(
    client: RadSecurityClient,
    provider: ProviderType,
    resource_type: string,
    resource_id: string
  ): Promise<any> {
    return client.makeRequest(
      `/accounts/${client.getAccountId()}/cloud-inventory/v1/${provider}/${resource_type}/${resource_id}`
    );
  }

• src/operations/cloud-inventory.ts:18-22 (schema)

  Zod schema defining the input parameters for the tool: provider, resource_type, and resource_id.

  export const GetCloudResourceDetailsSchema = z.object({
    provider: ProviderTypeEnum.describe("Cloud provider (aws, gcp, azure, linode)"),
    resource_type: z.string().describe("Type of cloud resource (to be fetched from get_cloud_resource_facet_values or from list_cloud_resources)"),
    resource_id: z.string().describe("ID of the cloud resource"),
  });

• src/index.ts:202-208 (registration)

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

    name: "get_cloud_resource_details",
    description:
      "Get detailed information about a specific cloud resource",
    inputSchema: zodToJsonSchema(
      cloudInventory.GetCloudResourceDetailsSchema
    ),
  },

• src/index.ts:856-871 (registration)

  Dispatch logic in the CallTool handler that validates input with the schema and calls the handler function.

  case "get_cloud_resource_details": {
    const args = cloudInventory.GetCloudResourceDetailsSchema.parse(
      request.params.arguments
    );
    const response = await cloudInventory.getCloudResourceDetails(
      client,
      args.provider,
      args.resource_type,
      args.resource_id
    );
    return {
      content: [
        { type: "text", text: JSON.stringify(response, null, 2) },
      ],
    };
  }