list_inbox_items
Retrieve security findings from RAD Security with optional filtering by field, severity, or search terms to manage Kubernetes and cloud security insights.
Instructions
List inbox items with optional filtering by any field. Multiple filters can be combined eg. 'search:cve-2024-12345 and severity:high'
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of inbox items per page (default: 10) | |
| offset | No | Offset to retrieve (default: 0) | |
| filters_query | No | Filter query string (e.g. full text search: 'search:<query>', severity: 'severity:low', type 'type:workflow_output' any other field). Multiple filters can be combined eg. 'search:cve-2024-12345 and severity:high' |
Implementation Reference
- src/operations/inbox.ts:35-51 (handler)Core handler function that makes the API request to list inbox items using the RadSecurityClient.
export async function listInboxItems( client: RadSecurityClient, limit: number = 10, offset: number = 0, filters_query?: string, ): Promise<any> { const params: Record<string, any> = { limit, offset }; if (filters_query) { params.filters_query = filters_query; } return client.makeRequest( `/accounts/${client.getAccountId()}/data/inbox_items`, params ); } - src/operations/inbox.ts:10-14 (schema)Zod schema defining the input parameters for the list_inbox_items tool.
export const ListInboxItemsSchema = z.object({ limit: z.number().optional().default(10).describe("Number of inbox items per page (default: 10)"), offset: z.number().optional().default(0).describe("Offset to retrieve (default: 0)"), filters_query: z.string().optional().describe("Filter query string (e.g. full text search: 'search:<query>', severity: 'severity:low', type 'type:workflow_output' any other field). Multiple filters can be combined eg. 'search:cve-2024-12345 and severity:high'"), }); - src/index.ts:491-495 (registration)Tool registration in the listTools response, providing name, description, and input schema.
name: "list_inbox_items", description: "List inbox items with optional filtering by any field. Multiple filters can be combined eg. 'search:cve-2024-12345 and severity:high'", inputSchema: zodToJsonSchema(inbox.ListInboxItemsSchema), }, - src/index.ts:1355-1370 (handler)MCP tool handler in the switch statement that validates input with schema, calls the core handler, and formats the response.
case "list_inbox_items": { const args = inbox.ListInboxItemsSchema.parse( request.params.arguments ); const response = await inbox.listInboxItems( client, args.limit, args.offset, args.filters_query ); return { content: [ { type: "text", text: JSON.stringify(response, null, 2) }, ], }; }