# Serasa Verify ID identity verification MCP. AI Agent Connect

> Serasa Verify ID connects your AI client to Serasa Experian's identity verification and enrichment database. You can submit registration data for people or companies to receive coded validation results, risk verdicts, and fraud scores. It handles both synchronous checks and asynchronous enrichment requests, allowing your agent to verify identities or enrich existing records with deep registration data.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qxtWb47NPNY7hm26huDY7bQHBJiofxpoJ8ZpONS6/ai-agent-connect
- **Tags:** serasa, experian, identity-verification, kyc, enrichment, fraud-score, brazil, pf, pj

## Description

You can use this MCP to cross-reference registration data against the Serasa base. When you provide details for a person or a company, the tool returns specific validation results for each attribute, along with a verification score and a risk verdict. It works for both individuals (PF) and legal entities (PJ). 

For deeper data, you can request enrichment. This pulls additional registration details and contracted fraud scores from Serasa. Some enrichment requests are asynchronous; in those cases, your agent will receive a request ID and can poll for the final data once it is ready. The MCP also includes local validation for specific parameters like packages and scores, which prevents you from wasting paid requests on invalid values. If you need to check Politically Exposed Persons, you can list available PEP files to see which snapshots are ready for consultation.

## Tools

### enrich_organization
Enriches company data using Verify ID registration details. If the response is asynchronous, your agent uses a request ID to poll for the final result.

### enrich_person
Adds registration packages and fraud scores to a person's profile. Your agent can poll for results if the enrichment process is asynchronous.

### get_organization_enrichment
Retrieves the results of an asynchronous company enrichment request using its specific request ID.

### get_person_enrichment
Fetches the completed data for a person after an asynchronous enrichment request is processed.

### list_pep_files
Shows the available PEP (politically exposed person) snapshots that your client can consult.

### verify_organization
Validates a company's CNPJ and registration data against the Serasa base to produce a verification score and risk verdict.

### verify_people_batch
Processes a list of multiple people in a single synchronous call, returning an array of verification results.

### verify_person
Checks an individual's registration data to generate a coded attribute validation and a risk score.

## Prompt Examples

**Prompt:** 
```
Verify the registration data for CPF 12345678901: name Joao Silva, born 1985-03-12, email joao@example.com.
```

**Response:** 
```
The agent calls verify_person and returns the attribute validation results, the verificationScore, and the verificationRisk verdict.
```

**Prompt:** 
```
Check a whole list of customers at once.
```

**Response:** 
```
The agent calls verify_people_batch with the JSON array and returns one verification result for every person in the list.
```

**Prompt:** 
```
Enrich CPF 12345678901 with the basic registration package and a fraud score.
```

**Response:** 
```
The agent calls enrich_person with the BASIC package and FRAUD_SCORE_PF, then polls get_person_enrichment until the data is ready.
```

## Capabilities

### Identity Validation
Your agent checks provided registration data against the Serasa database for accuracy.

### Risk Assessment
The tool generates verification scores and risk verdicts for individuals and companies.

### Data Enrichment
You can expand existing records with additional registration data and fraud scores.

### Batch Processing
Your agent can verify multiple people in a single request instead of individual calls.

### PEP Monitoring
The MCP allows you to list and consult available Politically Exposed Person snapshots.

## Use Cases

### Customer Onboarding
Your agent verifies a new user's CPF and name against Serasa to confirm they are who they say they are.

### Corporate Due Diligence
You use the organization verification tool to check a company's CNPJ and registration status.

### Bulk Identity Audits
An agent processes a large list of customers using batch verification to find discrepancies.

### Fraud Prevention
The tool pulls specific fraud scores to flag high-risk registration attempts during a transaction.

## Benefits

- Reduces failed API calls by validating parameters locally before sending requests.
- Handles asynchronous data retrieval automatically through polling mechanisms.
- Consolidates individual and corporate verification into a single interface.
- Provides coded attribute validation for granular accuracy.

## How It Works

Connecting to Serasa's data is a direct process managed through Vinkius.

1. Connect your AI client to the Serasa Verify ID MCP via Vinkius.
2. Provide your OAuth2 credentials from the Serasa developer portal.
3. Instruct your agent to run a verification or enrichment tool.
4. The agent performs the request, handling any necessary polling for asynchronous results.
5. Your agent receives the final validation scores or enriched data.

## Frequently Asked Questions

**How do I authenticate this MCP?**
You use OAuth2 client credentials issued through the Serasa Experian developer portal.

**Can I verify companies as well as people?**
Yes, you can use verify_organization for companies (PJ) and verify_person for individuals (PF).

**What happens if an enrichment request is asynchronous?**
The tool will return a requestId. Your agent must then use the get_person_enrichment or get_organization_enrichment tools to poll for the result.

**Does this MCP handle batch requests?**
Yes, the verify_people_batch tool allows you to verify a list of people in one synchronous call.

**How are fraud scores handled?**
You can request specific fraud scores during the enrichment process for individuals.

**What is the difference between verification and enrichment?**
Verification compares the data you send against the Serasa base and answers per attribute whether it matches, using verify_person / verify_organization / verify_people_batch. Enrichment returns the registration data Serasa actually holds for that document, plus the fraud scores you request, using enrich_person / enrich_organization.

**What do verificationScore and verificationRisk mean?**
verificationScore is the numeric score produced for that verification and verificationRisk is the verdict Serasa attaches to it, such as Risco baixo, Risco moderado or Risco alto. The distinct flag marks whether the registration data diverges from the data you informed.

**The enrichment came back with a requestId instead of the data — what now?**
Some packages are processed asynchronously. Poll get_person_enrichment or get_organization_enrichment with that requestId until the response carries the data instead of the pending marker.

**Which score parameters can I use?**
Person verification accepts VERIFY, VERIFY_DISTINCT, REQUEST and FRAUD; company verification accepts VERIFY, VERIFY_DISTINCT and REQUEST. Enrichment packages and scores are separate lists documented on each tool — the connector rejects anything outside them before calling the API.
