This project provides a server to connect AI agents with public Brazilian government data from over 41 APIs across 14 thematic areas. It aims to democratize access to complex governmental information, enabling AI agents to perform sophisticated analyses on topics ranging from economics and legislation to public health and security, thereby empowering researchers, developers, and power users.

How It Works

The architecture employs a "Package by Feature" approach, where each API integration is a self-contained module. An "Auto-Registry" system automatically discovers these features, eliminating manual configuration. The system prioritizes performance and reliability through asynchronous operations (httpx async, Pydantic v2) and robust rate limiting with backoff strategies, ensuring efficient and stable interaction with diverse public APIs.

Quick Start & Requirements

• Installation: pip install mcp-brasil
• Running: Use uvx --from mcp-brasil python -m mcp_brasil.server for stdio or fastmcp run mcp_brasil.server:mcp --transport http --port 8000 for an HTTP server.
• Prerequisites: Optional API keys for Portal da Transparência, DataJud/CNJ, and Meta Ad Library can be configured via environment variables.
• Links: Quick Start, Documentation, Features Catalog, Architecture.

Highlighted Details

• Integrates 309 tools across 39 features covering 14 key areas of Brazilian public data.
• 36 APIs require no authentication; 3 use free, easily obtainable keys.
• Features cross-referencing capabilities to combine data from multiple APIs for comprehensive analysis.
• Supports batch execution for parallel queries and smart discovery using BM25 search to filter relevant tools.
• Auto-registry simplifies adding new API integrations.

Maintenance & Community

The project encourages community contributions via issues and pull requests. Specific community channels (e.g., Discord, Slack) or notable contributors/sponsorships are not detailed in the README.

Licensing & Compatibility

The project is licensed under the MIT License, generally permitting broad use, including commercial applications. However, users should be aware of the disclaimer regarding potential inconsistencies in underlying government API documentation.

Limitations & Caveats

This project integrates numerous Brazilian government APIs, some of which may have inconsistent or incomplete documentation, potentially leading to unexpected results or partial data coverage. As a community-driven open-source project, users are encouraged to report any issues or suggest improvements. The server strictly accesses official government data without modification or editorialization.