Agrobr MCP

1# agrobr-mcp
2 
3[![PyPI](https://img.shields.io/pypi/v/agrobr-mcp)](https://pypi.org/project/agrobr-mcp/)
4[![Tests](https://github.com/bruno-portfolio/agrobr-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/bruno-portfolio/agrobr-mcp/actions/workflows/tests.yml)
5[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
6[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
7 
8**MCP server that gives LLMs access to real-time Brazilian agricultural data** — prices, crop estimates, climate, deforestation and more from 10 public sources.
9 
10![Demo](https://github.com/user-attachments/assets/76b6c45d-055e-4b36-aa10-02ae3f917aa8)
11 
12---
13 
14## Install
15 
16```bash
17pip install agrobr-mcp
18```
19 
20## Setup
21 
22### Claude Desktop
23 
24Add to `claude_desktop_config.json`:
25 
26```json
27{
28  "mcpServers": {
29    "agrobr": {
30      "command": "python",
31      "args": ["-m", "agrobr_mcp"]
32    }
33  }
34}
35```
36 
37### Cursor
38 
39Settings > MCP Servers > Add:
40 
41```json
42{
43  "agrobr": {
44    "command": "python",
45    "args": ["-m", "agrobr_mcp"]
46  }
47}
48```
49 
50### Claude Code
51 
52```bash
53claude mcp add agrobr python -- -m agrobr_mcp
54```
55 
56> If the above fails due to `-m` flag parsing, create a wrapper script:
57>
58> **Linux/macOS:** `echo 'python -m agrobr_mcp' > run.sh && chmod +x run.sh && claude mcp add agrobr ./run.sh`
59>
60> **Windows:** `echo python -m agrobr_mcp > run.bat && claude mcp add agrobr run.bat`
61 
62### Docker
63 
64```bash
65docker build -t agrobr-mcp .
66docker run --rm -i agrobr-mcp
67```
68 
69Add to `claude_desktop_config.json`:
70 
71```json
72{
73  "mcpServers": {
74    "agrobr": {
75      "command": "docker",
76      "args": ["run", "--rm", "-i", "agrobr-mcp"]
77    }
78  }
79}
80```
81 
82---
83 
84## Tools
85 
8610 tools available out of the box:
87 
88### Prices & Market
89 
90| Tool | Description |
91|------|-------------|
92| `preco_diario` | Daily spot prices for agricultural commodities (CEPEA/ESALQ) |
93| `futuros_b3` | Daily settlement prices for agricultural futures on B3 exchange |
94 
95### Production & Crop
96 
97| Tool | Description |
98|------|-------------|
99| `estimativa_safra` | Current crop season estimate by state (CONAB/IBGE) |
100| `producao_anual` | Historical annual production by state (IBGE PAM) |
101| `balanco` | Supply and demand balance — stock, consumption, exports (CONAB) |
102| `progresso_safra` | Weekly planting and harvesting progress by state (CONAB) |
103 
104### Climate & Environment
105 
106| Tool | Description |
107|------|-------------|
108| `clima` | Climate data by state — temperature, precipitation, radiation (NASA POWER) |
109| `desmatamento` | Deforestation rates and real-time alerts by biome (INPE) |
110 
111### Meta
112 
113| Tool | Description |
114|------|-------------|
115| `listar_produtos` | List valid products for each tool |
116| `health_check` | Check status of all data sources |
117 
118---
119 
120## Example queries
121 
122```
123"Qual o preço da soja nos últimos 5 dias?"
124"Estimativa de safra de milho por estado"
125"Progresso da colheita de soja"
126"Dados de desmatamento na Amazônia"
127"Quais produtos estão disponíveis?"
128```
129 
130---
131 
132## How it works
133 
134```
135User (natural language)
136    │
137MCP Client (Claude Desktop / Cursor / Claude Code)
138    │
139agrobr-mcp (this server — thin layer, text formatting)
140    │
141agrobr library (data collection, parsing, caching)
142    │
14319 public APIs (CEPEA, CONAB, IBGE, INPE, B3, NASA POWER…)
144```
145 
146agrobr-mcp is a thin wrapper. All data logic lives in the [agrobr](https://github.com/bruno-portfolio/agrobr) library.
147 
148---
149 
150## Development
151 
152```bash
153git clone https://github.com/bruno-portfolio/agrobr-mcp.git
154cd agrobr-mcp
155pip install -e ".[dev]"
156 
157# Run tests
158pytest tests/ -m "not integration" -v
159 
160# Lint
161ruff check src/ tests/
162ruff format src/ tests/
163```
164 
165---
166 
167## License
168 
169MIT
170 
171---
172 
173## PT-BR
174 
175### O que é o agrobr-mcp?
176 
177Servidor 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.
178 
179### Instalação
180 
181```bash
182pip install agrobr-mcp
183```
184 
185### Configuração
186 
187Adicione ao seu client MCP (Claude Desktop, Cursor ou Claude Code) conforme as instruções acima.
188 
189### Docker
190 
191```bash
192docker build -t agrobr-mcp .
193docker run --rm -i agrobr-mcp
194```
195 
196### 10 tools disponíveis
197 
198- **preco_diario** — Preço spot de commodities agrícolas (CEPEA/ESALQ)
199- **futuros_b3** — Ajustes diários de futuros agrícolas na B3
200- **estimativa_safra** — Estimativa da safra corrente por UF (CONAB/IBGE)
201- **producao_anual** — Produção histórica por UF (IBGE PAM)
202- **balanco** — Balanço de oferta e demanda (CONAB)
203- **progresso_safra** — Progresso semanal de plantio e colheita (CONAB)
204- **clima** — Dados climáticos por UF (NASA POWER)
205- **desmatamento** — Taxa de desmatamento e alertas por bioma (INPE)
206- **listar_produtos** — Lista produtos válidos por tool
207- **health_check** — Status das fontes de dados
208 
209### Links
210 
211- [agrobr library](https://github.com/bruno-portfolio/agrobr) — biblioteca de dados agrícolas
212- [MCP Protocol](https://modelcontextprotocol.io) — Model Context Protocol
213 
214mcp-name: io.github.bruno-portfolio/agrobr
215