Mcp-Brasil/mcp-brasil

What it solves

mcp-brasil is an MCP (Model Context Protocol) server that provides AI agents (such as Claude, GPT, and Copilot) with direct access to over 70 public data sources from the Brazilian government. It eliminates the need for manually searching through fragmented government portals, providing a unified interface for accessing economic, legislative, judicial, and social data.

How it works

The project implements a "Package by Feature" architecture with an auto-registry system. It offers three types of data access modalities:

• REST Passthrough: Asynchronous HTTP requests to official government APIs, processed via Pydantic for structured output.
• Local Datasets: For massive datasets (e.g., TSE election data, SIAPA property records), it downloads CSVs/ZIPs and stores them in an embedded DuckDB local cache for high-performance SQL queries.
• Intelligent Agents: Combines tools, prompts, and resources to handle complex workflows, such as official writing tasks.

It includes "Smart Tools" for discovery (BM25 search), batch execution of queries, and a query planner that can cross-reference data across multiple different APIs.

Who it’s for

• AI Agent Developers: Those building tools for researchers, journalists, and analysts who need reliable Brazilian government data.
• Data Analysts & Researchers: Users who want to use LLMs to query public data without writing custom API integrations for every source.
• Civic Tech Developers: Tech-driven transparency and transparency-focused applications.

Highlights

• Massive Coverage: 533 tools across 70 features covering 15 thematic areas (Economy, Health, Education, Justice, etc.).
• Hybrid Data Access: Combines real-time API calls with a local DuckDB-powered SQL engine for large-scale datasets.
• Cross-Referencing: Ability to create execution plans that combine data from multiple sources (e.g., combining a deputy's spending with their voting record).
• Low Friction: 66 of the 70 APIs require no API keys, making it easy to start immediately.
• Broad Integration: Supports Claude Desktop, VS Code/Cursor, and standard HTTP transports.