RoastnetRoastnet

API del mercado y MCP

API para integrar su sistema o su IA al mercado de café verde.

Mantenga sus lotes de café verde en Roastnet alineados con su sistema, gestione pedidos y solicitudes de muestras al instante y deje que un asistente de IA haga lo mismo en su cuenta.

API REST

Una sola clave, toda su operación de venta.

Cree una clave en su consola de Roastnet y envíela como Bearer token. La API cubre lotes, pedidos, muestras, ofertas y un feed de eventos, con webhooks para avisarle de cada cambio en el momento en que ocurre.

curl https://network.roastnet.ai/api/market/v1/lots \
  -H "Authorization: Bearer rnk_YOUR_KEY"
  • 01Liste, sincronice, actualice y retire lotes por su propia referencia.
  • 02Confirme, rechace y marque pedidos como despachados y entregados.
  • 03Vea solicitudes de muestras y márquelas como enviadas.
  • 04Hasta 120 solicitudes por minuto por clave; una respuesta 429 indica cuándo reintentar.

Agentes de IA (MCP)

Conecte su asistente de IA.

Roastnet ejecuta un servidor Model Context Protocol para el mercado de café verde. Conecte cualquier cliente MCP, y su asistente podrá explorar el mercado, listar, agregar, actualizar y retirar sus lotes por referencia, leer sus pedidos, ofertas y solicitudes de muestras, y marcar una muestra como enviada, bajo las mismas reglas que la API.

  1. Únase gratis al mercado de café verde o abra su consola de Roastnet.
  2. Abra Connect agent y cree un token para su asistente.
  3. Agregue el servidor de abajo a su cliente MCP y pegue el token.

Configuración del cliente MCP (JSON)

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

O desde un cliente de línea de comandos

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

Reemplace YOUR_TOKEN con el token de Connect agent. Los tokens pueden revocarse en cualquier momento desde el mismo lugar.

Para máquinas

Diseñado para ser detectable.

Los agentes y rastreadores pueden encontrar todo por sí solos: la tarjeta del servidor MCP en /.well-known/mcp.json, un resumen en texto plano en /llms.txt y el documento OpenAPI enlazado en esta página.

Preguntas

Lo que nos preguntan.

¿Quién puede usar la Market API?
Cualquier empresa que venda en el mercado de café verde de Roastnet, incluidos importadores, tostadores y exportadores, una vez que se una y cree una clave en su consola.
¿Cómo funciona la autenticación?
La API REST usa una clave de API enviada como Bearer token. El servidor MCP usa un token que usted crea en Connect agent, también enviado como Bearer token.
¿Dónde está la especificación OpenAPI?
En network.roastnet.ai/api/market/v1/openapi.json. Es pública y no requiere clave.

Términos de la Market API

Sus lotes, donde buscan sus compradores.

Únase gratis al mercado de café verde, cree una clave y conecte su sistema esta tarde.