Basedosdados Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Basedosdados Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
A Model Context Protocol (MCP) server that provides AI-optimized access to Base dos Dados, Brazil's largest open data platform.
#### Ask it to replicate a news article:
User:
https://www.gov.br/secom/pt-br/assuntos/noticias/2025/05/no-melhor-abril-do-novo-caged-brasil-gera-257-mil-vagas-com-carteira-assinada
consegue replicar a materia e checar os numeros?
Claude: https://claude.ai/public/artifacts/15d7f5c5-f017-4a96-9380-a93e535001fd#### Or a research question
User:
https://claude.ai/share/f8dbbe5b-1c34-4804-9462-1bfb9008558d
Claude: https://claude.ai/share/f8dbbe5b-1c34-4804-9462-1bfb9008558d####
Just run this line in your terminal
bash -i <(curl -LsSf https://raw.githubusercontent.com/JoaoCarabetta/basedosdados-mcp/refs/heads/main/install.sh)Add your BigQuery project_id, location and service account.
Restart Claude Desktop and you are good to go!
⚠️ I just tested it in my Mac M-Series
| Tool | Description |
|---|---|
search_datasets | Search datasets with Portuguese support |
get_dataset_overview | Get complete dataset overview with tables |
get_table_details | Get table details with columns and SQL samples |
execute_bigquery_sql | Execute SQL queries directly |
check_bigquery_status | Check BigQuery authentication |
Set up the MCP server for local development with live code reloading:
git clone https://github.com/JoaoCarabetta/basedosdados-mcp
cd basedosdados-mcp
./dev_install.shThis script will:
basedosdadosdev serverIf you prefer manual setup:
# Clone and install dependencies
git clone https://github.com/JoaoCarabetta/basedosdados-mcp
cd basedosdados-mcp
uv sync --extra dev
# Run development server
uv run basedosdados-mcp-dev
# Or test directly
./run_dev_server.shsrc/ are reflected immediatelybasedosdadosdev server in Claude DesktopInstall development dependencies and run the comprehensive test suite:
# Install dev dependencies (includes pytest)
uv sync --extra dev
# Run all encoding tests
pytest tests/ -v
# Run specific test categories
pytest tests/ -k "encoding" -v # Encoding tests only
pytest tests/ -k "live" -v # Live server tests only
pytest tests/ -m "not live" -v # Skip live tests (faster)
# Run with coverage
pytest tests/ --cov=basedosdados_mcp --cov-report=htmlThe pytest-based test suite includes:
Portuguese characters tested: população, educação, saúde, região, satélites, políticas, públicas, and 30+ more common Brazilian dataset terms.
Corruption patterns detected: é, á, Ã, ó, ú, ã, ç, ô, ê, à , õ (common UTF-8 corruption)
If you experience encoding issues in Claude Desktop (e.g., seeing satélites instead of satélites), run the tests to verify the issue is in the display layer, not the MCP server itself.
Base dos Dados is Brazil's largest open data platform, providing standardized access to Brazilian public datasets through BigQuery.
Data Coverage: Demographics, Economics, Education, Politics, Health, Environment
MIT License
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.