# Serasa Infomais is a data enrichment MCP. AI Agent Connect

> Serasa Infomais connects your AI client to Serasa Experian's massive database. You can pull specific attributes for individuals (CPF) or companies (CNPJ), ranging from contact details and income to business governance and compliance status. It also handles reverse lookups to find documents when you only have partial information like a name or phone number.

## Overview
- **Category:** marketing
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YTjAEfeigY4XhH4J7rHMkDgyFDoGUYxV6MSIkQKn/ai-agent-connect
- **Tags:** serasa, experian, enrichment, marketing, lead-enrichment, brazil, pf, pj, reverse-lookup

## Description

You can use this MCP to pull specific, billable data points from Serasa Experian on demand. Instead of paying for massive datasets you don't need, you tell your AI client exactly which attributes to fetch for a specific CPF or CNPJ. For people, this means getting identity details, contact info, income levels, or marketing affinities. For organizations, you can pull registration data, revenue estimates, or governance details like business partners and legal representatives. If you don't have a document number, you can use the reverse-lookup tools to find the right CPF or CNPJ using names, addresses, or phone numbers. This makes it easy to clean your lead lists or verify business credentials directly within your existing AI workflows.

## Tools

### enrich_organization
This tool enriches a CNPJ with specific attributes you request, such as registration status, revenue, or business partners.

### enrich_person
This tool pulls specific data for a CPF, including identity, contact info, income, and marketing affinities.

### filter_enrichment
This tool resolves loose data into candidate documents by returning a name, age, and location for a person or organization.

### find_organization_by_keys
This tool finds CNPJs using partial information like a corporate name, CEP, or phone number.

### find_person_by_keys
This tool identifies CPFs when you only have a name, address, phone, or birth date.

## Prompt Examples

**Prompt:** 
```
Enrich this lead: CPF 12345678901. I need name, contacts and marketing affinities.
```

**Response:** 
```
The agent calls enrich_person with the CPF and requested attributes, returning the name, addresses, phones, email, and affinity data.
```

**Prompt:** 
```
I have a company name and a city but no CNPJ. Can you find it?
```

**Response:** 
```
The agent calls find_organization_by_keys to search for the CNPJ using the name and city, returning a list of matching organizations.
```

**Prompt:** 
```
Check the registration status and partners of CNPJ 33014556000196.
```

**Response:** 
```
The agent calls enrich_organization to fetch the registrationStatus and businessPartners for that specific CNPJ.
```

## Capabilities

### Targeted Data Fetching
Your agent requests only the specific attributes needed to minimize costs.

### Identity Resolution
The AI finds exact documents from partial names or contact details.

### Business Intelligence
You get access to company sizing, revenue, and governance data.

### Compliance Checking
The agent can verify PEP, NIS, or cadastral status for individuals and firms.

### Marketing Profiling
Your agent can pull consumer affinities like e-commerce or travel interests.

## Use Cases

### Lead Enrichment
Turn a raw list of CPFs into a detailed profile containing income and contact info.

### Company Verification
Validate a business's registration status and legal representatives using a CNPJ.

### Customer Discovery
Search for a specific company or person when you only have a name and a city.

### Compliance Auditing
Check if a person or organization appears on specific regulatory lists.

## Benefits

- Pay only for the specific attributes you request.
- Find documents even when you only have partial contact info.
- Access deep Brazilian business and personal data through a single connection.
- Automate identity and compliance checks within your AI chat.

## How It Works

Connect your client to Vinkius and start querying Serasa data immediately.

1. Connect your MCP-compatible client to the Vinkius hosted MCP.
2. Provide your Serasa Experian OAuth2 credentials.
3. Ask your AI client to find or enrich a specific person or company.
4. The agent executes the corresponding tool and returns the requested data.

## Frequently Asked Questions

**How much does each request cost?**
You pay per attribute requested. Because you specify the exact attributes in the tool call, you only pay for the data you actually receive.

**Can I find a CNPJ if I don't have the number?**
Yes. You can use the find_organization_by_keys tool to search using a corporate name, CEP, or phone number.

**What kind of personal data can I retrieve?**
You can retrieve identity info, contact details, income levels, social class, and various marketing affinities for a CPF.

**Do I need to manage my own API keys?**
Vinkius hosts the MCP and manages the connection, but you will need to provide your Serasa Experian credentials for authentication.

**Which AI clients can I use with this MCP?**
You can use this with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**Which attributes should I request?**
Only the ones you will use — Infomais bills per requested attribute. The connector rejects attribute names the endpoint does not support, so a typo fails loudly instead of returning a partial record you pay for without noticing.

**What is the user_token for?**
The reverse-lookup endpoints (find_person_by_keys, find_organization_by_keys and filter_enrichment) require a user token in addition to the client token. Generate it in the same developer portal and pass it per call; the connector forwards it to the right header automatically.

**How do the distributor parameters work?**
They apply only to the distributor variant of Infomais. distributor_type selects the model (NONE, DH, OF or DW) and distributor_dw switches between Distributor DW and Distributor OF. enrich_organization also accepts indirect_sale_document for indirect sales. Leave them unset when your contract is the standard one.