# Claro Insight is a Brazil identity MCP. AI Agent Connect

> Claro Insight provides direct access to Claro Brasil's official API marketplace. Your agent can perform SIM tenure checks, GSMA KYC matching, and credit scoring via the Claro Score. It handles the OAuth authentication and token management automatically, letting you focus on building secure onboarding and antifraud workflows in Brazil.

## Overview
- **Category:** security
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_viC4KG1Kmu6YpsR8VK6jBGOat13KlOxpz1GV4idL/ai-agent-connect
- **Tags:** claro, kyc, identity-verification, credit-score, facial-biometrics, onboarding, brazil

## Description

You can now give your AI agent direct access to Claro Brasil's carrier-grade identity and scoring suite. This MCP acts as a bridge to the official Claro Insight marketplace, allowing your agent to pull real-time data for identity verification, fraud prevention, and credit assessment. Instead of building complex OAuth flows for the GSMA Open Gateway suite, you connect this MCP to your client and start making calls immediately. 

When you're building fintech apps or digital onboarding flows in Brazil, you need more than just basic data. This MCP lets your agent verify if a phone number actually belongs to a specific CPF, check if a user's address matches their mobile network footprint, and even pull credit scores for unbanked consumers. It's built for high-stakes automation where identity certainty is the priority. Whether you're running a KYC match to prevent account takeover or using facial biometric lookups to confirm a user's identity, this MCP handles the heavy lifting of communicating with Claro's infrastructure.

## Tools

### validate_phone
This tool checks if a specific CPF is the registered owner of a Claro mobile line. It helps you catch mis-typed numbers or borrowed lines during onboarding.

### kyc_match
This tool compares user-provided identity data like name, birthdate, and ID against verified Claro records. It provides a per-field verdict to help identify fraud during account opening.

### kyc_fill_in
This tool pulls authorized registration data like full name, CPF, and address directly from Claro records. You can use it to pre-fill onboarding forms and increase conversion rates.

### validate_address
This tool uses antenna-proximity scoring to confirm if a CPF and phone number actually belong to a specific address. It's a reliable way to flag fake addresses in credit or delivery flows.

### get_credit_score
This tool retrieves a Claro Score from 0 to 1000 based on actual payment behavior. It provides credit risk data even for consumers who are unbanked.

### check_face_biometrics
This tool checks if a CPF has a registered facial biometric in the Claro database. You can use the result to decide whether to proceed with a face comparison or fall back to document checks.

### get_sim_tenure
This tool checks how long a Claro Brasil number has been active and identifies the associated plan. It serves as a strong trust signal for assessing the risk of a new account.

## Prompt Examples

**Prompt:** 
```
Check how long the phone 5511999999999 has been a Claro customer
```

**Response:** 
```
The tenure check for 5511999999999 shows the activation period on the Claro network and the current plan. This data can be used as a trust signal during onboarding.
```

**Prompt:** 
```
Validate that CPF 12345678909 is the owner of the Claro line 5521987654321
```

**Response:** 
```
The Valida Telefone check confirms whether CPF 12345678909 matches the registered owner of line 5521987654321. A mismatch indicates a borrowed or incorrect number.
```

**Prompt:** 
```
Validate that CPF 12345678909 with name João da Silva and birthdate 1990-01-01 matches Claro records for +5511999999999
```

**Response:** 
```
The KYC Match tool has compared the provided name, CPF, and birthdate against Claro's verified records for +5511999999999. The payload contains the per-field match verdict.
```

## Capabilities

### Identity Verification
Your agent uses KYC tools to match user data against carrier records.

### Fraud Prevention
The agent checks SIM tenure and address proximity to flag high-risk users.

### Credit Assessment
Your agent pulls Claro Scores to evaluate creditworthiness for unbanked individuals.

### Automated Onboarding
The agent uses KYC Fill-In to populate user profiles from carrier data.

### Biometric Validation
Your agent checks for existing facial biometrics to streamline identity workflows.

## Use Cases

### Digital Bank Onboarding
Use KYC Match and KYC Fill-In to verify new customers and populate their profiles instantly.

### Credit Risk Triage
Apply Claro Score to new loan applicants to assess risk based on mobile payment history.

### Account Takeover Prevention
Run validate_phone and check_face_biometrics to ensure the person accessing an account is the legitimate owner.

### Delivery Verification
Use validate_address to ensure a customer's location matches their registered mobile footprint.

## Benefits

- Accesses official Claro Brasil carrier data directly.
- Automates OAuth token management and refreshing.
- Provides credit scoring for the unbanked population.
- Reduces onboarding friction through automated data filling.

## How It Works

Connecting to this MCP gives your agent immediate access to Claro's API suite.

1. Register your app in the Claro Insight marketplace to get credentials.
2. Connect the MCP to your AI client via Vinkius.
3. The MCP automatically handles OAuth token minting and refreshing.
4. Your agent calls specific tools to perform identity or credit checks.
5. The agent receives structured data to make real-time decisions.

## Frequently Asked Questions

**How do I handle authentication for this MCP?**
You need to register an app in the Claro Insight marketplace to get a Client ID and Client Secret. The MCP manages the OAuth client_credentials flow and token refreshes for you.

**Do I need a Customer ID for all tools?**
Some legacy customer APIs require a Customer ID in the header, which is an optional credential you can provide in this MCP.

**What happens if a KYC match fails?**
A failed field in a KYC match is a strong signal of identity fraud. If a response says a customer is not found, it means the data is not in the Claro base, not necessarily a mismatch.

**Can this MCP score people without bank accounts?**
Yes, the Claro Score is built from mobile payment behavior, allowing it to score unbanked consumers.

**Is the data provided by this MCP official?**
Yes, this MCP provides access to the official Claro Brasil API marketplace.
