mcp-agro-brasil

MCP server de dados do agronegócio brasileiro: cotações de boi gordo, soja, milho e leite, calendário de safra (CONAB), previsão do tempo, câmbio PTAX, exportações agro e notícias do setor.

Parte da família MCP Brasil junto com mcp-fiscal-brasil e mcp-juridico-brasil.

O que é

mcp-agro-brasil conecta qualquer cliente MCP (Claude Desktop, Claude Code, outros) a indicadores do agronegócio brasileiro em tempo quase real:

• Boi gordo - cotação regional por praça via Scot Consultoria e indicador nacional ESALQ/B3

• Soja - indicador CEPEA/ESALQ Porto de Paranaguá (R$/saca 60 kg)

• Milho - indicador CEPEA/ESALQ (R$/saca 60 kg)

• Leite - preço ao produtor CEPEA por estado (R$/litro)

• Clima - previsão do tempo (máxima, mínima, chuva) para cidades brasileiras via Open-Meteo

• Câmbio - cotação PTAX oficial USD/BRL via Banco Central do Brasil

• Exportações - volume (kg/ton) e valor FOB (USD) exportado de soja, carne bovina e milho via Comex Stat / MDIC

• Notícias - últimas manchetes do agronegócio via RSS (Canal Rural), com filtro por tema

• Calendário de safra - janelas de plantio e colheita por cultura e região, curado do CONAB

• Futuros B3 - informação sobre contratos BGI, CCM, SFI, ICF (fonte paga; alternativas indicadas)

• Conversões - arroba, saca, hectare, alqueire e outras unidades do agro

Os dados de cotação são obtidos por scraping de páginas públicas com cache local. Clima e câmbio usam APIs JSON abertas e gratuitas.

Related MCP server: agrobr-mcp

Instalação rápida

A forma mais simples, sem instalação permanente:

uvx mcp-agro-brasil

Ou instale com pip/uv:

pip install mcp-agro-brasil
# ou
uv add mcp-agro-brasil

Configuração MCP

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agro-brasil": {
      "command": "uvx",
      "args": ["mcp-agro-brasil"]
    }
  }
}

Claude Code

claude mcp add agro-brasil -- uvx mcp-agro-brasil

Ou adicione ao .claude/settings.json do projeto:

{
  "mcpServers": {
    "agro-brasil": {
      "command": "uvx",
      "args": ["mcp-agro-brasil"]
    }
  }
}

Ferramentas disponíveis

Exemplos de retorno

cotacao_boi_gordo("GO Goiânia")

{
  "praca": "GO Goiânia",
  "a_vista": 312.50,
  "trinta_dias": 315.00,
  "unidade": "R$/@",
  "moeda": "BRL",
  "fonte": "Scot Consultoria",
  "data_consulta": "2026-06-27T10:00:00",
  "cache_hit": false
}

cotacao_soja()

{
  "indicador": "Soja CEPEA/ESALQ - Paranaguá",
  "a_vista": 142.30,
  "unidade": "R$/saca 60 kg",
  "moeda": "BRL",
  "fonte": "CEPEA/ESALQ via Notícias Agrícolas",
  "data_consulta": "2026-06-27T10:00:00"
}

converter(50, "arroba", "kg")

{
  "valor_original": 50.0,
  "de_unidade": "arroba",
  "resultado": 735.0,
  "para_unidade": "kg"
}

Praças suportadas (boi gordo)

GO Goiânia, MS Campo Grande, MT Cuiabá, MG Belo Horizonte, SP Araçatuba, SP Barretos, SP Presidente Prudente, SP São José do Rio Preto, PR Cascavel, RS Porto Alegre, PA Redenção, BA Feira de Santana.

Para praças fora desta lista, o sistema usa fallback para o indicador nacional ESALQ/B3.

Estados suportados (leite)

RS, SC, PR, SP, MG, GO, BA, RJ, ES e Brasil (média nacional).

Fontes e atribuição

• Scot Consultoria - cotações regionais de boi gordo: scotconsultoria.com.br

• ESALQ/B3 via Notícias Agrícolas - indicador nacional boi gordo: noticiasagricolas.com.br

• CEPEA/ESALQ via Notícias Agrícolas - soja, milho e leite: noticiasagricolas.com.br

• Open-Meteo - previsão do tempo: open-meteo.com (API aberta, sem token)

• Banco Central do Brasil (PTAX) - câmbio USD/BRL: olinda.bcb.gov.br (API aberta, sem token)

• Comex Stat / MDIC - exportações do agronegócio: comexstat.mdic.gov.br (API aberta, sem token)

• Canal Rural - notícias do agronegócio: canalrural.com.br (RSS público)

Aviso legal

Os indicadores CEPEA/ESALQ (soja, milho, leite e boi gordo ESALQ/B3) são produzidos pela ESALQ-USP / CEPEA e distribuídos sob licença Creative Commons BY-NC (não comercial, com atribuição). Este projeto é de uso informativo e educacional, com atribuição completa da fonte em todas as respostas.

Para uso comercial ou redistribuição em produto pago, obtenha licença junto ao CEPEA (cepea.esalq.usp.br) ou um provedor licenciado (ex.: Agrolink, Notícias Agrícolas via contrato).

O scraping respeita as fontes: cache local de 15 minutos, sem sobrecarga de requisições.

Roadmap

Entregue

• Boi gordo - cotação regional (Scot Consultoria) + indicador nacional (ESALQ/B3)

• Soja - indicador CEPEA/ESALQ Porto de Paranaguá

• Milho - indicador CEPEA/ESALQ

• Leite - preço ao produtor CEPEA por estado

• Conversões de unidades (arroba, saca, hectare, alqueire, tonelada...)

• Clima - previsão do tempo por cidade via Open-Meteo

• Câmbio USD/BRL PTAX via Banco Central do Brasil

• Exportações do agronegócio via Comex Stat / MDIC (soja, carne bovina, milho)

• Notícias do agronegócio via RSS (Canal Rural)

Onda 3 - Safra e Mercado Futuro

• Calendário de safra via CONAB (soja, milho 1a/2a, feijão, café, sorgo, algodão - 5 regiões)

• Futuros B3 (BGI, CCM, SFI, ICF) - tool implementada; fonte paga não integrada (brapi.dev Pro / Cedro)

Próximos

• Integrar futuros B3 quando fonte gratuita ou open-access estiver disponível

Desenvolvimento

git clone https://github.com/DeHor-Labs/mcp-agro-brasil.git
cd mcp-agro-brasil

# Instalar com uv
uv sync --extra dev

# Rodar testes
uv run pytest

# Lint
uv run ruff check .
uv run ruff format .

Licença

MIT - ver LICENSE.

Desenvolvido por Nikolas de Hor - nikolasdehor79@gmail.com