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, notícias do setor e integração opcional com as APIs oficiais AgroAPI/Embrapa.

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)
• AgroAPI/Embrapa (opcional) - AGROFIT, ZARC e cultivares Agritec, Bioinsumos e AgroTermos
• 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.

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"]
    }
  }
}

AgroAPI/Embrapa (opcional)

As APIs AGROFIT v1, Agritec v2, Bioinsumos v2 e AgroTermos v1 exigem cadastro, criação de aplicação e assinatura no portal AgroAPI da Embrapa. Sem credenciais, o servidor inicia normalmente e as tools AgroAPI não são registradas.

Configure o par de credenciais da aplicação:

{
  "mcpServers": {
    "agro-brasil": {
      "command": "uvx",
      "args": ["mcp-agro-brasil"],
      "env": {
        "AGROAPI_CLIENT_ID": "CONSUMER_KEY_DA_APLICACAO",
        "AGROAPI_CLIENT_SECRET": "CONSUMER_SECRET_DA_APLICACAO"
      }
    }
  }
}

Também são aceitos os nomes oficiais AGROAPI_CONSUMER_KEY e AGROAPI_CONSUMER_SECRET. Para desenvolvimento, um token já emitido pode ser fornecido em AGROAPI_TOKEN ou AGROAPI_ACCESS_TOKEN.

Não salve credenciais no repositório. Com AGROAPI_CLIENT_ID e AGROAPI_CLIENT_SECRET, o cliente usa OAuth 2.0 client_credentials, mantém o token somente em memória e tenta renová-lo uma vez após uma resposta HTTP 401. Tokens fornecidos por AGROAPI_TOKEN ou AGROAPI_ACCESS_TOKEN são estáticos, não são renovados automaticamente e devem ser substituídos manualmente.

Ferramentas disponíveis

Ferramentas AgroAPI opcionais

Estas tools aparecem somente quando a autenticação AgroAPI está configurada:

As respostas de AGROFIT e Bioinsumos são informativas. Elas não constituem prescrição agronômica; confirme registro vigente, cultura, alvo, rótulo/bula, receituário e orientação de profissional habilitado antes do uso.

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)
• AgroAPI / Embrapa Agricultura Digital - AGROFIT, Agritec, Bioinsumos e AgroTermos: portal.agroapi.cnptia.embrapa.br

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)
• Integração opcional AgroAPI/Embrapa: AGROFIT, Agritec v2, Bioinsumos v2 e AgroTermos

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
• Avaliar ClimAPI, SATVeg e SmartSolos após validação de contratos e planos

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