# Consultas — how to use (mcp.ai)

Consultas em fontes oficiais sobre pessoas e empresas: situação cadastral (CPF/CNPJ), Simples/MEI, SINTEGRA, certidões (CND Federal, CNDT, FGTS), TCU, sanções (OFAC/ONU/ICIJ) e NF-e. 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_consultas?ms=1781045340000`
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. `consultas_antecedentes_sp`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/consultas`
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/consultas/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/consultas/antecedentes/sp` — Certidão de antecedentes criminais do estado de SP por nome.
  - body: { nome: string, birthdate: string, genero: string }
- `POST https://api.mcp.ai/api/consultas/bcb/valores/receber` — Valores a Receber no Banco Central (SVR) — verifica se uma pessoa ou empresa tem dinheiro esquecido a resgatar. PF: informe cpf + data_nascimento. PJ: informe cnpj + data_abertura_empresa. Síncrono.
  - body: { cpf?: string, data_nascimento?: string, cnpj?: string, data_abertura_empresa?: string }
- `POST https://api.mcp.ai/api/consultas/cnd/estadual` — Certidão Negativa de Débitos Estaduais (CND estadual) de um estado, por CNPJ/CPF/IE. Informe a UF.
  - body: { uf: string, cnpj?: string, cpf?: string, ie?: string }
- `POST https://api.mcp.ai/api/consultas/cnd/federal` — Certidão de débitos federais e Dívida Ativa da União (CND Federal/PGFN) por CNPJ ou CPF.
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/cndt` — Certidão Negativa de Débitos Trabalhistas (CNDT) por CNPJ ou CPF.
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/cpf` — Situação cadastral de um CPF na Receita (nome, situação, nascimento, inscrição, óbito). Requer CPF + data de nascimento.
  - body: { cpf: string, birthdate: string }
- `POST https://api.mcp.ai/api/consultas/fgts` — Regularidade do empregador perante o FGTS (Certificado de Regularidade — CRF) por CNPJ.
  - body: { cnpj: string }
- `POST https://api.mcp.ai/api/consultas/irpf` — Comprovante/situação da Declaração de IRPF de um CPF, por ano-calendário.
  - body: { cpf: string, birthdate: string, year: string }
- `POST https://api.mcp.ai/api/consultas/marcas` — Marcas registradas no INPI por titular (CPF ou CNPJ).
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/mei` — Dados do MEI (Microempreendedor Individual) por CPF ou CNPJ.
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/nfe` — Consulta uma Nota Fiscal Eletrônica (NF-e) pela chave de acesso (44 dígitos).
  - body: { nfe: string }
- `POST https://api.mcp.ai/api/consultas/offshore/leaks` — Busca na base ICIJ Offshore Leaks (paraísos fiscais) por nome/termo.
  - body: { query: string }
- `POST https://api.mcp.ai/api/consultas/patentes` — Patentes registradas no INPI por titular (CPF ou CNPJ).
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/sancoes/ofac` — Busca em listas de sanções do OFAC (EUA) por nome/termo.
  - body: { query: string }
- `POST https://api.mcp.ai/api/consultas/sancoes/onu` — Busca em listas de sanções da ONU por nome/termo.
  - body: { query: string }
- `POST https://api.mcp.ai/api/consultas/simples` — Situação no Simples Nacional / SIMEI de um CNPJ.
  - body: { cnpj: string }
- `POST https://api.mcp.ai/api/consultas/sintegra/rj` — Situação cadastral de ICMS (SINTEGRA) no estado do RJ por CNPJ ou CPF.
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/sintegra/sp` — Situação cadastral de ICMS (SINTEGRA) no estado de SP por CNPJ ou CPF.
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/sintegra/suframa` — Situação cadastral na SUFRAMA por CNPJ ou CPF.
  - body: { cnpj?: string, cpf?: string }
- `POST https://api.mcp.ai/api/consultas/tcu/pj` — Consulta consolidada do TCU para uma PJ (inidôneos, inabilitados, contas irregulares) por CNPJ.
  - body: { cnpj: string }

## Example prompts
- "Esse CNPJ tem CND Federal negativa e CNDT?"
- "Situação cadastral do CPF 000.000.000-00 (nascido em 01/01/1990)?"
- "Esse nome aparece em listas de sanções (OFAC/ONU)?"

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