# Claro Antifraud (Open Gateway) AI Agent Connect > Claro Antifraud (Open Gateway) provides direct access to the official Claro Brasil gateway. Your AI client uses this MCP to perform critical security checks like SIM swap detection, device location verification, and number recycling audits. It's built for risk agents and fintechs who need to validate the legitimacy of a mobile line before approving high-value actions. ## Overview - **Category:** security - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_myBLx5JOdItSyHyRTouK2kphUFk0gwdLuSnoBeAV/ai-agent-connect - **Tags:** claro, sim-swap, account-takeover, antifraud, device-location, number-recycling, gsma, brazil ## Description You can use this MCP to pull real-time security signals from the Claro Brasil network. Instead of guessing if a user is legitimate, your agent can check if a SIM card was swapped just minutes before a password reset attempt. You can also verify if a phone number has been recycled to a new owner, ensuring your customer database remains accurate. For location-based security, the MCP lets your agent confirm if a device is within a specific geographic radius or retrieve its last known cell-level position. This is essential for preventing account takeovers and validating physical presence during sensitive transactions. All authentication and token management happen in the background, so you just connect your client and start querying. ## Tools ### check_sim_swap Checks if a Claro number had a SIM card swap within a specified hour window. Use this to catch account takeover attempts during sensitive sessions. ### get_sim_swap_date Retrieves the exact timestamp of the last SIM change for a Claro number. This provides the forensic detail needed for fraud case reviews. ### get_line_change_alerts Monitors recent operational changes on a mobile line including SIM swaps, device changes, or subscription cancellations. It's a primary signal for detecting hijacked accounts. ### check_number_recycling Verifies if a phone number was reassigned to a new owner after a specific date. Use this to clean up stale contact lists and prevent sending data to the wrong person. ### verify_device_location Confirms if a device is located within a specific lat/long radius. This requires user consent under LGPD and works while the device is on the Claro data network. ### retrieve_device_location Fetches the last known location area and timestamp for a device on the Claro network. It provides a specific area rather than a simple yes/no verification. ### get_lbs_device_location Provides cell-level location data including coordinates and accuracy radius. This is a lightweight way to perform regional checks or asset monitoring. ## Prompt Examples **Prompt:** ``` Has the SIM of +5511999999999 been swapped in the last 24 hours? ``` **Response:** ``` SIM Swap check for +5511999999999: The response shows the SIM was swapped within the 24-hour window, which is a high-risk signal for account takeover. I can also pull the exact timestamp using get_sim_swap_date if you need it for your records. ``` **Prompt:** ``` Was the number 5521912345678 recycled since January 2025? ``` **Response:** ``` Number Recycling check for 5521912345678: This number was reassigned to a new owner after 2025-01-01. Any existing customer data tied to this number is likely outdated and belongs to a different person. ``` **Prompt:** ``` Is the device of 5511974129777 within 5 km of -23.627, -46.655? ``` **Response:** ``` Device Location check for 5511974129777: The device is confirmed to be within the 5 km radius of the specified coordinates. Note that this check requires the device to be on the Claro network and requires LGPD consent. ``` ## Capabilities ### Account Takeover Detection Your agent identifies recent SIM swaps to block unauthorized password resets. ### Geofencing and Verification The MCP confirms if a user's device is physically located within a required area. ### Database Hygiene Your agent flags recycled phone numbers to prevent contacting the wrong individuals. ### Forensic Auditing You retrieve exact timestamps of line changes to build detailed fraud investigation reports. ### Automated Authentication The MCP handles OAuth token minting and refreshing automatically in the background. ## Use Cases ### High-Value Transaction Security An agent checks for recent SIM swaps before allowing a large bank transfer to proceed. ### User Onboarding Validation A fintech verifies that a phone number hasn't been recycled to a stranger during sign-up. ### Delivery Verification A logistics agent confirms a device is within a specific radius to validate a delivery attempt. ### Account Recovery Protection The system blocks password resets if the SIM card was changed within the last few hours. ## Benefits - Direct access to official Claro Brasil gateway data. - Automated OAuth credential management and token refreshing. - Real-time signals for SIM swaps and device movements. - Reduced manual investigation time through precise forensic timestamps. ## How It Works Connecting to this MCP gives your AI client immediate access to Claro's security tools. 1. Register your application in the Claro Insight marketplace to get your credentials. 2. Connect your MCP-compatible client to Vinkius. 3. Provide your Client ID, Client Secret, and Customer ID to the MCP. 4. Your agent sends requests to tools like check_sim_swap or verify_device_location. 5. The MCP automatically handles OAuth token minting and header injection. ## Frequently Asked Questions **How do I authenticate this MCP?** You need to register an app in the Claro Insight marketplace to obtain a Client ID, Client Secret, and Customer ID. The MCP handles the OAuth token generation and automatic refreshing for you. **Does device location tracking require user permission?** Yes, all device location tools require user consent to comply with LGPD regulations. **What happens if I get a 429 error during location checks?** A 429 error means you have hit the per-MSISDN rate limit for the LBS service. You should slow down your requests for that specific number rather than retrying immediately. **Can I check if a number was reassigned to someone else?** Yes, the check_number_recycling tool allows you to verify if a number has been assigned to a new owner since a specific date. **Which clients can I use with this MCP?** You can use this MCP with any compatible client, including Claude, Cursor, Windsurf, and VS Code.