RAD Security

Instructions

Implementation Reference

• src/index.ts:581-586 (registration)

  Tool registration in listTools handler: defines name 'radql_list_data_types' with description and schema reference

  {
    name: "radql_list_data_types",
    description:
      "List all available RadQL data types (discovery). ALWAYS call this FIRST before using other RadQL tools to discover what data is available to query. Returns data types like 'containers', 'kubernetes_resources', 'inbox_items', 'vulnerabilities', etc. with descriptions.",
    inputSchema: zodToJsonSchema(radql.RadQLListDataTypesSchema),
  },

• src/index.ts:1535-1542 (handler)

  Dispatch handler in callToolRequest: calls radql.executeListDataTypes(client) for this tool

  case "radql_list_data_types": {
    const response = await radql.executeListDataTypes(client);
    return {
      content: [
        { type: "text", text: JSON.stringify(response, null, 2) },
      ],
    };
  }

• src/index.ts:582-586 (registration)

  Tool listed with name and schema in ListToolsRequest handler

    name: "radql_list_data_types",
    description:
      "List all available RadQL data types (discovery). ALWAYS call this FIRST before using other RadQL tools to discover what data is available to query. Returns data types like 'containers', 'kubernetes_resources', 'inbox_items', 'vulnerabilities', etc. with descriptions.",
    inputSchema: zodToJsonSchema(radql.RadQLListDataTypesSchema),
  },

• src/operations/radql.ts:8-13 (schema)

  Zod schema definition for the tool input (empty object, no params)

  /**
   * Schema for listing available data types (discovery)
   */
  export const RadQLListDataTypesSchema = z.object({}).describe(
    "List all available RadQL data types. Returns data types with descriptions. ALWAYS call this FIRST to discover what data is available."
  );

• src/operations/radql.ts:304-309 (handler)

  Tool handler function: executeListDataTypes, calls core listDataTypes

   */
  export async function executeListDataTypes(
    client: RadSecurityClient
  ): Promise<any> {
    return await listDataTypes(client);
  }

• src/operations/radql.ts:113-127 (handler)

  Core handler logic: listDataTypes makes API request to /data/types and formats response

  /**
   * List all available data types that can be queried
   */
  export async function listDataTypes(
    client: RadSecurityClient
  ): Promise<any> {
    const response = await client.makeRequest(
      `/accounts/${client.getAccountId()}/data/types`
    );
  
    return {
      available_types: Array.isArray(response) ? response : response.available_types || [],
      hint: "Use radql_get_type_metadata with a specific data_type to see available fields and filtering options"
    };
  }