agrobr

The agrobr MCP Server provides real-time Brazilian agricultural data to large language models by wrapping multiple public data sources into a single, easy-to-use MCP endpoint. It enables you to query prices, crop estimates, climate data, deforestation alerts, and more from sources like CEPEA, CONAB, IBGE, INPE, and B3, helping your LLMs make informed, data-driven responses.

How to use

You integrate this server with an MCP client (such as Claude Desktop, Cursor, or Claude Code) to enable natural-language queries that retrieve up-to-date agricultural data. The server acts as a thin wrapper around the underlying data library, returning structured results you can present to users or feed into downstream workflows.

How to install

Prerequisites: you need Python and a working environment where you can install Python packages.

pip install agrobr-mcp

Configuration for MCP clients

Configure your MCP client to connect to agrobr-mcp using a standard stdio setup. You will run the server as a local Python process and point the client to it using the following configuration.

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

Claude Desktop setup guidance

Add the agrobr MCP server to Claude Desktop by placing the following configuration in claude_desktop_config.json.

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

Cursor setup guidance

In Cursor, add a MCP server with the following settings under Settings > MCP Servers.

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

Claude Code setup guidance

In Claude Code, register the MCP server with the following command sequence.

claude mcp add agrobr python -- -m agrobr_mcp

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

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

## Tools and capabilities

The server exposes a collection of tools that provide access to different data streams. Each tool retrieves specific data from public sources and returns it in a structured format.

## Available tools

- preco\_diario — Daily spot prices for agricultural commodities (CEPEA/ESALQ)
- futuros\_b3 — Daily settlement prices for agricultural futures on B3 exchange
- estimativa\_safra — Current crop season estimate by state (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)
- clima — Climate data by state — temperature, precipitation, radiation (NASA POWER)
- desmatamento — Deforestation rates and real-time alerts by biome (INPE)
- listar\_produtos — List valid products for each tool
- health\_check — Check status of all data sources" , 

## Notes on usage and guidelines

The agrobr MCP Server is designed to be used as a data backbone for your LLM queries. When you ask questions in natural language, your MCP client forwards the request to agrobr\_mcp, which formats the query and retrieves data from the agrobr library. The library handles data collection, parsing, and caching from 19 public APIs, ensuring you receive up-to-date information in a consistent structure.

## Development and testing

To contribute or run tests locally, follow the development workflow: clone the repository, install the development dependencies, run tests, and format code.

## Available tools

### preco\_diario

Daily spot prices for agricultural commodities from CEPEA/ESALQ.

### futuros\_b3

Daily settlement prices for agricultural futures on the B3 exchange.

### estimativa\_safra

Current crop season estimates by state from CONAB/IBGE.

### producao\_anual

Historical annual production by state from IBGE PAM.

### balanco

Supply and demand balance including stocks, consumption, and exports from CONAB.

### progresso\_safra

Weekly planting and harvesting progress by state from CONAB.

### clima

Climate data by state including temperature, precipitation, and radiation from NASA POWER.

### desmatamento

Deforestation rates and real-time alerts by biome from INPE.

### listar\_produtos

Lists valid products for each tool.

### health\_check

Checks the status of all data sources.