batch_phone
Read-onlyIdempotent
Verify multiple US phone numbers for scam risks simultaneously by analyzing against 10M+ intelligence records from FTC, FCC, and threat databases, returning individual risk scores and summary results.
Instructions
Look up multiple phone numbers in a single request (max 100). Each number is checked individually with the same analysis as check_phone. Returns results array with per-item risk scores and a summary.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone_numbers | Yes | Array of US phone numbers (1-100) | |
| force_refresh | No | Force fresh lookups, bypassing cache (default: false) |
Implementation Reference
- src/index.ts:307-329 (handler)The `batch_phone` tool is registered using `server.tool` and handles multiple phone number lookups by calling the `/api/v1/batch/phone` endpoint.
server.tool( 'batch_phone', 'Look up multiple phone numbers in a single request (max 100). Each number is checked individually with the same analysis as check_phone. Returns results array with per-item risk scores and a summary.', { phone_numbers: z.array(z.string()).min(1).max(100).describe('Array of US phone numbers (1-100)'), force_refresh: z.boolean().optional().describe('Force fresh lookups, bypassing cache (default: false)'), }, { title: 'Batch Phone Lookup', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, async ({ phone_numbers, force_refresh }) => { try { const data = await apiPost('/api/v1/batch/phone', { phone_numbers, force_refresh }); return jsonResult(data); } catch (err) { return errorResult(err instanceof Error ? err.message : 'Batch phone lookup failed'); } }, );