RoastnetRoastnet

API do mercado e MCP

API e integrações para torrefadores de café.

Mantenha seus lotes de café verde na Roastnet alinhados ao seu sistema, aja em pedidos e solicitações de amostras assim que chegarem e deixe um assistente de IA fazer o mesmo na sua conta.

Leia a documentação da API Entre no mercado de café verde grátis

API REST

Uma chave, toda a operação de venda.

Crie uma chave no seu console da Roastnet e envie como Bearer token. A API cobre lotes, pedidos, amostras, ofertas e um feed de eventos, com webhooks para avisar cada mudança no momento em que acontece.

curl https://network.roastnet.ai/api/market/v1/lots \
  -H "Authorization: Bearer rnk_YOUR_KEY"
  • 01Liste, sincronize, atualize e retire lotes pela sua própria referência.
  • 02Confirme, recuse e marque pedidos como despachados e entregues.
  • 03Veja solicitações de amostras e marque amostras como enviadas.
  • 04Até 120 requisições por minuto por chave; uma resposta 429 informa quando tentar novamente.

Agentes de IA (MCP)

Conecte seu assistente de IA.

A Roastnet executa um servidor Model Context Protocol para o mercado de café verde. Conecte qualquer cliente MCP e seu assistente poderá navegar o mercado, listar, adicionar, atualizar e retirar seus lotes por referência, ler seus pedidos, ofertas e solicitações de amostras e marcar uma amostra como enviada, sob as mesmas regras da API.

  1. Entre no mercado de café verde grátis ou abra seu console da Roastnet.
  2. Abra o Connect agent e crie um token para seu assistente.
  3. Adicione o servidor abaixo ao seu cliente MCP e cole o token.

Configuração do cliente MCP (JSON)

{
  "mcpServers": {
    "roastnet-market": {
      "type": "http",
      "url": "https://network.roastnet.ai/api/network/fitter-mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Ou a partir de um cliente de linha de comando

claude mcp add --transport http roastnet-market \
  https://network.roastnet.ai/api/network/fitter-mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Substitua YOUR_TOKEN pelo token do Connect agent. Tokens podem ser revogados a qualquer momento no mesmo lugar.

Para máquinas

Projetado para ser descoberto.

Agentes e crawlers podem encontrar tudo sozinhos: o cartão do servidor MCP em /.well-known/mcp.json, uma visão geral em texto simples em /llms.txt e o documento OpenAPI com link nesta página.

Perguntas

O que nos perguntam.

Quem pode usar a Market API?
Qualquer empresa que venda no mercado de café verde da Roastnet, incluindo importadoras, torrefações e exportadoras, depois de aderir e criar uma chave no console.
Como funciona a autenticação?
A API REST usa uma chave de API enviada como Bearer token. O servidor MCP usa um token criado no Connect agent, também enviado como Bearer token.
Onde está a especificação OpenAPI?
Em network.roastnet.ai/api/market/v1/openapi.json. É pública e não requer chave.

Termos da Market API

Também no mercado de café verde

Todos que o mercado reúne.

Comprar café verde Lotes de origem, importadores e torrefações em um só lugar.Vender excedente de café verde Torrefações: venda o verde que não vai torrar.Para importadores Cadastre seus lotes, mantenha seus clientes e fature direto para eles.Para produtores e exportadores Venda direto para torrefações especiais, com a Roastnet cuidando do resto.

Seus lotes, onde seus compradores procuram.

Entre no mercado de café verde grátis, crie uma chave e conecte seu sistema esta tarde.

Participar grátis Documentação completa da API