agrobr-mcp

MCP server that gives LLMs access to real-time Brazilian agricultural data — prices, crop estimates, climate, deforestation and more from 10 public sources from agrobr.

Install

Version 0.2.0 requires agrobr >=2.0.0,<3 and MCP Python SDK >=2.0.0,<3.

pip install agrobr-mcp

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agrobr": {
      "command": "python",
      "args": ["-m", "agrobr_mcp"]
    }
  }
}

Cursor

Settings > MCP Servers > Add:

{
  "agrobr": {
    "command": "python",
    "args": ["-m", "agrobr_mcp"]
  }
}

Claude Code

claude mcp add agrobr python -- -m agrobr_mcp

If the above fails due to -m flag parsing, create a wrapper script:

Linux/macOS: echo 'python -m agrobr_mcp' > run.sh && chmod +x run.sh && claude mcp add agrobr ./run.sh

Windows: echo python -m agrobr_mcp > run.bat && claude mcp add agrobr run.bat

Docker

docker build -t agrobr-mcp .
docker run --rm -i agrobr-mcp

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agrobr": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "agrobr-mcp"]
    }
  }
}

Tools

14 tools available out of the box:

Prices & Market

Production & Crop

Climate & Environment

Meta

Example queries

"Qual o preço da soja nos últimos 5 dias?"
"Estimativa de safra de milho por estado"
"Progresso da colheita de soja"
"Dados de desmatamento na Amazônia"
"Quais produtos estão disponíveis?"

How it works

User (natural language)
    │
MCP Client (Claude Desktop / Cursor / Claude Code)
    │
agrobr-mcp (this server — thin layer, text formatting)
    │
agrobr library (data collection, parsing, caching)
    │
19 public APIs (CEPEA, CONAB, IBGE, INPE, B3, NASA POWER…)

agrobr-mcp is a thin wrapper. All data logic lives in the agrobr library.

Development

git clone https://github.com/bruno-portfolio/agrobr-mcp.git
cd agrobr-mcp
pip install -e ".[dev]"

# Run tests
pytest tests/ -m "not integration" -v

# Lint
ruff check src/ tests/
ruff format src/ tests/

License

MIT

PT-BR

O que é o agrobr-mcp?

Servidor MCP que dá acesso a dados agrícolas brasileiros em tempo real para LLMs. Preços, safras, clima, desmatamento e mais — tudo de fontes públicas como CEPEA, CONAB, IBGE, INPE e B3.

Instalação

A versão 0.2.0 requer agrobr >=2.0.0,<3 e MCP Python SDK >=2.0.0,<3.

pip install agrobr-mcp

Configuração

Adicione ao seu client MCP (Claude Desktop, Cursor ou Claude Code) conforme as instruções acima.

Docker

docker build -t agrobr-mcp .
docker run --rm -i agrobr-mcp

14 tools disponíveis

• preco_diario — Preço spot de commodities agrícolas (CEPEA/ESALQ)
• futuros_b3 — Ajustes diários de futuros agrícolas na B3 (por padrão, o último pregão publicado)
• exportacao — Exportações agrícolas somadas por mês, por produto e UF de origem (Comex Stat; ABIOVE como reserva)
• estimativa_safra — Estimativa de safra por UF, por padrão a safra mais recente com dado (CONAB/IBGE)
• producao_anual — Produção histórica por UF (IBGE PAM)
• balanco — Balanço de oferta e demanda (CONAB)
• progresso_safra — Progresso semanal de plantio e colheita (CONAB)
• serie_historica_safra — Série histórica por safra: área, produção e produtividade; por padrão os últimos 10 anos (CONAB)
• rebanho — Rebanhos e produção animal por UF, por padrão o ano mais recente publicado (IBGE PPM)
• clima — Dados climáticos por UF (NASA POWER)
• desmatamento — Polígonos de desmatamento (PRODES do ano anterior ao corrente, recuando mais um ano se vier vazio) e alertas (DETER, últimos 15 dias) por bioma, com filtros opcionais de ano e UF, até 2.000 registros (INPE)
• queimadas — Focos de calor de um dia por município e bioma, satélite de referência (INPE)
• listar_produtos — Lista produtos válidos por tool
• health_check — Status das fontes de dados

Links

• agrobr library — biblioteca de dados agrícolas
• MCP Protocol — Model Context Protocol

mcp-name: io.github.bruno-portfolio/agrobr