RoastnetRoastnet

API do mercado e MCP

API, integrações e MCP: ligue o seu sistema ao mercado de café verde.

Mantenha os seus lotes de café verde na Roastnet alinhados com o seu sistema, trate de encomendas e pedidos de amostras quando chegam e deixe um assistente de IA fazer o mesmo na sua conta.

Ler a documentação da API Adira ao mercado de café verde gratuitamente

API REST

Uma chave, todo o lado de venda.

Crie uma chave na sua consola Roastnet e envie-a como Bearer token. A API abrange lotes, encomendas, amostras, ofertas e um feed de eventos, com webhooks, para saber de cada alteração no momento em que ocorre.

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 encomendas como expedidas e entregues.
  • 03Veja pedidos de amostras e marque amostras como enviadas.
  • 04Até 120 pedidos por minuto, por chave. Uma resposta 429 indica quando voltar a tentar.

Agentes de IA (MCP)

Ligue o seu assistente de IA.

A Roastnet opera um servidor Model Context Protocol para o mercado de café verde. Ligue qualquer cliente MCP e o seu assistente pode navegar no mercado, listar, adicionar, atualizar e retirar os seus lotes por referência, ler as suas encomendas, ofertas e pedidos de amostras, e marcar uma amostra como enviada, sob as mesmas regras da API.

  1. Adira ao mercado de café verde gratuitamente ou abra a sua consola Roastnet.
  2. Abra o Connect agent e crie um token para o 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 comandos

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. Os tokens podem ser revogados a qualquer momento no mesmo local.

Para máquinas

Pensada para ser descoberta.

Agentes e crawlers encontram tudo sozinhos: a ficha do servidor MCP em /.well-known/mcp.json, um resumo em texto simples em /llms.txt e o documento OpenAPI ligado a partir desta 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 importadores, torrefações e exportadores, desde que adira e crie uma chave na sua consola.
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 os que o mercado reúne.

Comprar café verde Lotes de origem, importadores e torrefações num só local.Vender excedente de café verde Torrefações: venda o verde que não vai torrar.Para importadores Liste os seus lotes, mantenha os seus clientes e fature-os diretamente.Para produtores e exportadores Venda diretamente a torrefações de especialidade, com a Roastnet a tratar do resto.

Os seus lotes, onde os compradores procuram.

Adira ao mercado de café verde gratuitamente, crie uma chave e ligue o seu sistema esta tarde.

Adira gratuitamente Documentação completa da API