Brazilian Sanctions

by williamoliv

299 downloads
Not rated
GitHub

About

An MCP (Model Context Protocol) server that provides access to Brazilian sanctions databases through the Porta da Transparência API.

Details

Author
williamoliv
Downloads
299
Categories
Other

- Multi-Register Search: unified access to five Brazilian sanctions registers.
- Automated Entity Analysis: check sanction status, authorities, and geographical data.
- Batch & Comprehensive Reporting: execute batch searches and generate compliance reports.
- Robust Input Processing: accepts raw or formatted CNPJ/CPF with automatic cleaning.
- Secure API key handling via local environment variables.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Brazilian Sanctions
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Obtain an API key from the Portal da Transparência, set it as the environment variable PORTAL_TRANSPARENCIA_API_KEY in a .env file, and add the server configuration to your MCP-compliant client using the provided BrazillianSanctions.json file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "brazilian sanctions": {
            "brazilian-sanctions": {
                "command": "python",
                "args": [
                    "\\mcp_server.py"
                ],
                "env": {
                    "PORTAL_TRANSPARENCIA_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

McpServers

{
    "brazilian-sanctions": {
        "command": "python",
        "args": [
            "\\mcp_server.py"
        ],
        "env": {
            "PORTAL_TRANSPARENCIA_API_KEY": "your_api_key_here"
        }
    }
}

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.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.