RAD Security

Instructions

Implementation Reference

• src/operations/cloud-inventory.ts:93-101 (handler)

  The async handler function that executes the tool logic by calling the RAD Security API to fetch facet values for the specified provider and facet.

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

• src/operations/cloud-inventory.ts:30-33 (schema)

  Zod input schema for the tool, validating provider and facet_id parameters.

  export const GetCloudResourceFacetValuesSchema = z.object({
    provider: ProviderTypeEnum.describe("Cloud provider (aws, gcp, azure, linode)"),
    facet_id: z.string().describe("ID of the facet"),
  });

• src/index.ts:218-224 (registration)

  Tool registration in the ListTools response, specifying the tool name, description, and input schema.

    name: "get_cloud_resource_facet_value",
    description:
      "Get values for a specific facet from a cloud provider",
    inputSchema: zodToJsonSchema(
      cloudInventory.GetCloudResourceFacetValuesSchema
    ),
  },

• src/index.ts:886-900 (registration)

  Tool execution handler in the CallToolRequest switch statement, which parses input, calls the core handler, and formats the response.

  case "get_cloud_resource_facet_value": {
    const args = cloudInventory.GetCloudResourceFacetValuesSchema.parse(
      request.params.arguments
    );
    const response = await cloudInventory.getCloudResourceFacetValues(
      client,
      args.provider,
      args.facet_id
    );
    return {
      content: [
        { type: "text", text: JSON.stringify(response, null, 2) },
      ],
    };
  }