Open Source MCP Server

Brazilian PEP MCP Server

Access Brazilian PEP (Politically Exposed Persons) and federal public servants data through the Portal da Transparência API. Enable AI agents to search, analyze, and report on political exposure and public servant information.

View on mcp.so View on GitHub
Overview

What It Does

This MCP server provides comprehensive access to Brazilian PEP data and federal executive branch servers, enabling automated due diligence, compliance checks, and public servant analysis through AI agents.

PEP Search

Search by CPF, name, function, agency, or date ranges

Server Data

Access federal executive branch servers and remuneration

Comprehensive Info

Get complete PEP status and functions/positions data

Features

Key Capabilities

Search PEPs

Search Politically Exposed Persons by CPF, name, function, agency, or date ranges with comprehensive filtering.

Search Servidores

Query federal executive branch servers (civil and military) by CPF, name, agency, type, or situation.

Remuneration Data

Access server remuneration data by CPF, ID, month/year for salary analysis and transparency.

Agency Aggregation

Search servers aggregated by agency and query functions and positions of trust.

Data Sources

Available Data

Source Purpose Search By
PEPs Politically Exposed Persons CPF, Name, Function, Agency, Date Ranges
Servidores Federal Executive Branch Servers CPF, Name, Agency, Type, Situation
Remuneração Server Remuneration CPF, ID, Month/Year
Por Órgão Servers by Agency Agency Code, Type, Link Type
Technical Specifications

System Details

  • Protocol: Model Context Protocol (MCP)
  • Transport: StdIO
  • Authentication: Portal da Transparência API Key
  • Async: Async-compatible tool execution

Secure API Key

API key is required and handled via local environment variables. Never commit your API key to version control.

Getting Started

Quick Setup

1. Get API Key

Visit portaldatransparencia.gov.br, login and generate an API key under 'Desenvolvedor'

2. Setup .env

Create .env file with PORTAL_TRANSPARENCIA_API_KEY=your_key_here

3. Run Server

Run with python mcp_server.py or integrate with your MCP client

Server Configuration
{
  "mcpServers": {
    "brazilian-pep": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "PORTAL_TRANSPARENCIA_API_KEY": "your_api_key_here"
      }
    }
  }
}
MCP Tools

Available Tools

search_peps

Search PEPs by CPF, name, function, agency, or date ranges

get_pep_info

Get comprehensive PEP information for a person by CPF

search_servidores

Search federal executive branch servers by CPF, name, agency, type, or situation

get_servidor_by_id

Get specific server by ID

search_servidores_remuneracao

Search server remuneration by CPF or ID and month/year

search_servidores_por_orgao

Search servers aggregated by agency

search_funcoes_e_cargos

Search functions and positions of trust

Open Source

Explore the Code

Full documentation, setup instructions, and tool definitions available in the repository.

View Repository