How to add agrobr-mcp to Windsurf

Give LLMs real-time Brazilian agricultural data — prices, crop estimates, climate and deforestation from public sources. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 25★ · stdio · no auth

Windsurf config for agrobr-mcp

pip install agrobr-mcp

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

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the agrobr-mcp config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5agrobr-mcp's tools become available to Cascade.

Before you start

Python 3.11+
pip install agrobr-mcp (or Docker)

What agrobr-mcp can do in Windsurf

preco_diario

Daily spot prices for agricultural commodities (CEPEA/ESALQ).

futuros_b3

Daily settlement prices for agricultural futures on the 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).

Security

No authentication or API keys required; all data is fetched from public Brazilian government and exchange sources. Data accuracy and availability depend entirely on those upstream public APIs.

agrobr-mcp + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the agrobr-mcp config there under the "mcpServers" key and restart the client.

Is agrobr-mcp safe to use with Windsurf?

No authentication or API keys required; all data is fetched from public Brazilian government and exchange sources. Data accuracy and availability depend entirely on those upstream public APIs.

Does it require an API key?

No. All data comes from public Brazilian government and exchange sources, so no authentication or API keys are needed.

What is the relationship to the agrobr library?

agrobr-mcp is a thin MCP wrapper that handles tool exposure and text formatting. All data collection, parsing, and caching logic lives in the separate agrobr Python library.

How do I install it in Claude Code?

Run `claude mcp add agrobr python -- -m agrobr_mcp`. If the `-m` flag fails to parse, create a wrapper script (run.sh / run.bat) and add that instead.

View repo Full agrobr-mcp page