Brazilian agricultural data for LLMs — prices, crops, climate, deforestation.
agrobr MCP Server
The io.github.bruno-portfolio/agrobr MCP server provides LLMs access to real-time Brazilian agricultural data. Its scope includes prices, crop estimates, and climate, and the project is described as focused on Brazilian agricultural information for LLM consumption.
🛠️ Key Features
Real-time Brazilian agricultural data access
Data categories: prices
Data categories: crop estimates
Data categories: climate
🚀 Use Cases
Retrieve Brazilian agricultural pricing information for LLM workflows
Provide crop estimate context for analysis or question answering
Use climate-related data from Brazil in agricultural data tasks
⚡ Developer Benefits
Python-oriented project targeting Python 3.11+
Distributed as a package on PyPI
MIT-licensed codebase (license noted in repository excerpt)
⚠️ Limitations
Supported data types are limited to prices, crop estimates, and climate as described in the provided excerpt
Additional capabilities beyond these categories are not specified in the source text
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.
Demo
Install
Version 0.2.0 requires agrobr >=2.0.0,<3 and MCP Python SDK >=2.0.0,<3.
Daily spot prices for agricultural commodities (CEPEA/ESALQ)
futuros_b3
Daily settlement prices for agricultural futures on B3 exchange (latest published session by default)
exportacao
Agricultural exports summed by month, by product and state of origin (Comex Stat; ABIOVE fallback)
Production & Crop
Tool
Description
estimativa_safra
Crop estimate by state, latest season with data by default (CONAB/IBGE)
producao_anual
Historical annual production by state (IBGE PAM)
balanco
Supply and demand balance — stock, consumption, exports (CONAB)
progresso_safra
Weekly planting and harvesting progress by state (CONAB)
serie_historica_safra
Historical crop series by season — area, production, yield; last 10 years by default (CONAB)
rebanho
Livestock herds and animal products by state, latest published year by default (IBGE PPM)
Climate & Environment
Tool
Description
clima
Climate data by state — temperature, precipitation, radiation (NASA POWER)
desmatamento
Deforestation polygons (PRODES for the previous calendar year, falling back one more year when empty) and alerts (DETER, last 15 days) by biome, with optional year and state filters, up to 2,000 records (INPE)
queimadas
Fire hotspots of one day by municipality and biome, reference satellite (INPE)
Meta
Tool
Description
listar_produtos
List valid products for each tool
health_check
Check status of all data sources
Example queries
code
"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
code
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
bash
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.
bash
pip install agrobr-mcp
Configuração
Adicione ao seu client MCP (Claude Desktop, Cursor ou Claude Code) conforme as instruções acima.
Docker
bash
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)