Brazilian Sanctions MCP Server
This MCP server provides standardized access to the Brazilian Federal Government’s sanctions databases via the Portal da Transparência API. It enables LLM-based agents to programmatically query, analyze, and report on entity compliance and sanction status, facilitating automated AML (Anti-Money Laundering) and due diligence workflows.
Core Capabilities
Multi-Register Search: Unified access to five key Brazilian registers: CNEP (National Register of Punishments), CEPIM (Sanctioned Public Employees), CEIS (Ineligible Entities), CEAF (Ineligible Public Servants), and Leniency Agreements.
Automated Entity Analysis: Go beyond simple search with tools for checking active sanction status, identifying sanctioning authorities, and mapping geographical data (UF/Location).
Batch & Comprehensive Reporting: Execute batch searches for multiple CNPJs/CPFs and generate formatted textual compliance reports in a single operation.
Robust Input Processing: The server includes automated document cleaning, accepting both raw and formatted strings for CNPJ and CPF.
Security First: Implements secure API key handling via local environment variables, ensuring integration compatibility with private AI environments.
Use Cases
Compliance Automation: Integrate real-time sanction screening directly into IDEs or agentic AI workflows.
Due Diligence: Automatically verify business partners or public entities against federal records.
Risk Assessment: Streamline the extraction of sanction reasons, dates, and regulatory metadata.
Technical Specifications
Protocol: Model Context Protocol (MCP)
Transport: StdIO
Authentication: Requires a Portal da Transparência API Key.
Data Sources: Official Brazilian Portal da Transparência API.
Getting Started
Obtain API Key: Register at Portal da Transparência and generate a key under the "Desenvolvedor" section.
Configuration: Create a .env file in your project root with your PORTAL_TRANSPARENCIA_API_KEY.
Integration: Add the server configuration to your MCP-compliant client (e.g., Claude Desktop, Cursor) using the provided BrazillianSanctions.json configuration file.
For full documentation, setup instructions, and tool definitions, please visit the repository.
Server Config
{
"mcpServers": {
"brazilian-sanctions": {
"command": "python",
"args": [
"\\mcp_server.py"
],
"env": {
"PORTAL_TRANSPARENCIA_API_KEY": "your_api_key_here"
}
}
}
}