# Investigação Cadastral — how to use (mcp.ai)

Investigação cadastral de pessoas e empresas: localização (endereço/telefone/email), vínculos e relacionamentos societários, participações, beneficiário final, renda estimada, óbito e propriedade veicular. Hospedado pela plataforma, sem credenciais, pague por consulta com crédito pré-pago.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_investigacao?ms=1782513960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `investigacao_aml`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/investigacao`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/investigacao/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/investigacao/aml` — Rede de vínculos societários para prevenção à lavagem de dinheiro, por CPF.
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/beneficiario/final` — Beneficiário final (UBO) de uma empresa ou pessoa.
  - body: { CNPJ?: string, CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/beneficios/sociais` — Benefícios sociais recebidos por um CPF (Bolsa Família, BPC, etc.).
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/cnh` — Dados da CNH (Carteira Nacional de Habilitação) por CPF.
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/enriquecimento` — Descobre a pessoa por trás de um celular e/ou email (enriquecimento reverso).
  - body: { CELULAR?: string, EMAIL?: string }
- `POST https://api.mcp.ai/api/investigacao/historico/veicular` — Histórico veicular (SP) por CPF ou CNPJ.
  - body: { CPF?: string, CNPJ?: string }
- `POST https://api.mcp.ai/api/investigacao/localizacao` — Localização de uma pessoa (nome, endereço, telefone, email).
  - body: { CPF?: string, NAME?: string, SURNAME?: string, DOB?: string }
- `POST https://api.mcp.ai/api/investigacao/obito` — Verificação de óbito por CPF.
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/participacoes` — QSA + participações societárias de um CNPJ (sócios e empresas ligadas).
  - body: { CNPJ?: string }
- `POST https://api.mcp.ai/api/investigacao/pessoa/fisica` — Dados cadastrais completos de um CPF: nome, contato (telefone/email), endereço, renda estimada e faixa salarial.
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/pessoa/juridica` — Dados cadastrais completos de um CNPJ.
  - body: { CNPJ?: string }
- `POST https://api.mcp.ai/api/investigacao/pis` — PIS vinculado a um CPF.
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/prf/infracoes` — Infrações da Polícia Rodoviária Federal por placa + RENAVAM.
  - body: { PLACA: string, RENAVAM: string, TIPO: string }
- `POST https://api.mcp.ai/api/investigacao/propriedade/veicular` — Veículos no nome de uma pessoa ou empresa (frota) por CPF/CNPJ.
  - body: { CPF?: string, CNPJ?: string }
- `POST https://api.mcp.ai/api/investigacao/renda` — Nível socioeconômico e renda estimada de um CPF.
  - body: { CPF?: string }
- `POST https://api.mcp.ai/api/investigacao/situacao/eleitoral` — Situação eleitoral de uma pessoa (TSE).
  - body: { NOME?: string, CPF?: string, NUMEROTITULOELEITORAL?: string, DATANASCIMENTO?: string }
- `POST https://api.mcp.ai/api/investigacao/titulo/eleitoral` — Título e local de votação (TSE).
  - body: { NOME?: string, CPF?: string, NUMEROTITULOELEITORAL?: string, DATANASCIMENTO: string, NOMEMAE: string }
- `POST https://api.mcp.ai/api/investigacao/veiculo/placa` — Dados e débitos de um veículo pela placa (não exige RENAVAM).
  - body: { PLACA?: string }
- `POST https://api.mcp.ai/api/investigacao/vinculo/empregaticio` — Vínculos empregatícios.
  - body: { CNPJ?: string }
- `POST https://api.mcp.ai/api/investigacao/vinculos/societarios` — Vínculos/relacionamentos societários de uma pessoa ou empresa.
  - body: { CNPJ?: string, CPF?: string }

## Example prompts
- "Localize a pessoa do CPF 000.000.000-00 (endereço e telefone)"
- "Quais empresas o CNPJ X tem vínculo societário?"
- "Quem é o beneficiário final dessa empresa?"

## More
- Page: https://mcp.ai/investigacao
- Agent spec (llms.txt): https://mcp.ai/investigacao/llms.txt
- Postman collection: https://mcp.ai/investigacao/postman.json