check_phone
Read-onlyIdempotent
Verify US phone numbers for scam reports, robocall flags, carrier information, and community alerts. Get risk scores and detailed threat intelligence from FTC, FCC, and carrier data sources.
Instructions
Look up a US phone number to check for scam reports, carrier info, network status, robocall flags, and community reports. Returns a risk score (0-100), verdict, and detailed signals from FTC, FCC, carrier, and community data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone_number | Yes | US phone number to look up (any format: +1XXXXXXXXXX, (XXX) XXX-XXXX, etc.) | |
| force_refresh | No | Force a fresh lookup, bypassing cache (default: false) |
Implementation Reference
- src/index.ts:147-169 (handler)The 'check_phone' tool is defined using server.tool. It takes phone_number and force_refresh as inputs, calls the '/api/v1/phone/lookup' endpoint, and handles success/error responses.
server.tool( 'check_phone', 'Look up a US phone number to check for scam reports, carrier info, network status, robocall flags, and community reports. Returns a risk score (0-100), verdict, and detailed signals from FTC, FCC, carrier, and community data.', { phone_number: z.string().describe('US phone number to look up (any format: +1XXXXXXXXXX, (XXX) XXX-XXXX, etc.)'), force_refresh: z.boolean().optional().describe('Force a fresh lookup, bypassing cache (default: false)'), }, { title: 'Check Phone Number', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, async ({ phone_number, force_refresh }) => { try { const data = await apiPost('/api/v1/phone/lookup', { phone_number, force_refresh }); return jsonResult(data); } catch (err) { return errorResult(err instanceof Error ? err.message : 'Phone lookup failed'); } }, );