# Transparência (CGU) — how to use (mcp.ai)

Consulta no Portal da Transparência do Governo Federal: sanções (CEIS, CNEP, CEPIM) e Pessoas Expostas Politicamente (PEP) por CPF/CNPJ para due diligence e compliance, e despesas recebidas por favorecido (quanto uma empresa recebeu da União, por órgão e por mês, com os documentos de empenho/liquidação/pagamento). Cobre o Executivo Federal. Hospedado pela plataforma; sem credencial do usuário.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_transparencia?ms=1788961800000`
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. `transparencia_despesas_documentos`).

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

### Endpoints
- `POST https://api.mcp.ai/api/transparencia/despesas/documentos` — Documentos de despesa (Empenho, Liquidação ou Pagamento) emitidos pelo Governo Federal para um favorecido (CPF/CNPJ) num ano, item-a-item: data, documento, espécie, valor, órgão, elemento de despesa e
  - body: { cpf_cnpj: string, ano?: integer, fase?: string, ordenacao?: integer, pagina?: integer }
- `POST https://api.mcp.ai/api/transparencia/despesas/favorecido` — DESPESAS recebidas por uma empresa ou pessoa (CPF/CNPJ) do Governo Federal num período: 'quanto a empresa recebeu da União'. Soma os recursos recebidos e quebra por órgão pagador e por mês. IMPORTANTE
  - body: { cpf_cnpj: string, mes_ano_inicio?: string, mes_ano_fim?: string }
- `POST https://api.mcp.ai/api/transparencia/pep` — Verifica se um CPF é de Pessoa Exposta Politicamente (PEP) e retorna função/órgão/período. Importante para compliance/KYC.
  - body: { cpf: string }
- `POST https://api.mcp.ai/api/transparencia/sancoes` — Consulta sanções de uma pessoa ou empresa por CPF/CNPJ no Portal da Transparência (consolida CEIS — inidôneas/suspensas, CNEP — empresas punidas, e CEPIM — entidades impedidas). Retorna `tem_sancao` +
  - body: { cpf_cnpj: string }

## Example prompts
- "Quanto a empresa do CNPJ 00.000.000/0001-00 recebeu do governo federal nos últimos 12 meses?"
- "A empresa desse CNPJ tem alguma sanção (CEIS/CNEP)?"
- "Liste os pagamentos federais feitos a esse CNPJ em 2025"

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