check_sim_swap
Check if a phone number has experienced a SIM swap or eSIM change in the last 24 hours. Use this to verify service disruptions or assess SMS authentication risks.
Instructions
Detect whether a SIM swap or eSIM provisioning event has occurred on a phone number in the last 24 hours. Uses Twilio Lookup v2 with live carrier data. Returns swapped (bool), swap timestamp, and current carrier. Use when a user reports losing mobile service, or before completing a high-risk action that depends on SMS-based authentication. Pay-as-you-go: $0.25 USDC per check (x402 on Base). Subscription: rapidapi.com/relayshield
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phone | Yes | Phone number in E.164 format (e.g. +14155551234) |
Implementation Reference
- src/relayshield_mcp/server.py:89-111 (registration)The tool is registered in list_tools() with name='check_sim_swap', description explaining SIM swap detection, and inputSchema requiring a 'phone' in E.164 format.
types.Tool( name="check_sim_swap", description=( "Detect whether a SIM swap or eSIM provisioning event has occurred on a phone number " "in the last 24 hours. Uses Twilio Lookup v2 with live carrier data. " "Returns swapped (bool), swap timestamp, and current carrier. " "Use when a user reports losing mobile service, or before completing a high-risk " "action that depends on SMS-based authentication. " "Pay-as-you-go: $0.25 USDC per check (x402 on Base). " "Subscription: rapidapi.com/relayshield" ), inputSchema={ "type": "object", "required": ["phone"], "properties": { "phone": { "type": "string", "description": "Phone number in E.164 format (e.g. +14155551234)", "pattern": "^\\+[1-9]\\d{6,14}$", } }, }, ), - src/relayshield_mcp/server.py:303-308 (handler)The handler dispatches a POST request to the /sim-swap endpoint, passing the phone argument as JSON.
if name == "check_sim_swap": return await client.post( f"{base}/sim-swap", headers=headers, json={"phone": arguments["phone"]}, ) - src/relayshield_mcp/server.py:47-53 (schema)PAYG pricing dictionary entry: check_sim_swap costs $0.25 USDC.
"check_sim_swap": "$0.25 USDC", "check_domain_lookalikes": "$0.50 USDC", "check_oauth_watchlist": "$0.15 USDC", "check_scan_result": "$0.00 USDC (free — poll result of a paid scan)", "scan_url": "coming soon", "scan_file": "coming soon", } - src/relayshield_mcp/server.py:21-21 (helper)Comment/docstring documenting PAYG pricing for check_sim_swap as $0.25.
check_sim_swap $0.25