RoastnetRoastnet

Market API y MCP

API e integraciones: conecte su stock o su IA al mercado de café verde.

Mantenga sus lotes de café verde en Roastnet sincronizados con su sistema, gestione pedidos y solicitudes de muestra en cuanto lleguen, y deje que un asistente de IA haga lo mismo en su cuenta.

Leer la documentación de la API Únase gratis al mercado de café verde

API REST

Una clave, toda la venta.

Cree una clave en su consola de Roastnet y envíela como token Bearer. 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 enviados y entregados.
  • 03Vea solicitudes de muestra y marque las muestras como enviadas.
  • 04Hasta 120 solicitudes por minuto y 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, añadir, actualizar y retirar sus lotes por referencia, leer sus pedidos, ofertas y solicitudes de muestra, 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. Añada 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"

Sustituya YOUR_TOKEN por el token de Connect agent. Puede revocar los tokens en cualquier momento desde el mismo lugar.

Para máquinas

Descubrible por diseño.

Los agentes y rastreadores pueden encontrar todo por sí mismos: la tarjeta del servidor MCP en /.well-known/mcp.json, un resumen en texto plano en /llms.txt y el documento OpenAPI enlazado desde 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 haya unido y haya creado una clave en su consola.
¿Cómo funciona la autenticación?
La API REST usa una clave de API enviada como token Bearer. El servidor MCP usa un token que usted crea en Connect agent, también enviado como token Bearer.
¿Dónde está la especificación OpenAPI?
En network.roastnet.ai/api/market/v1/openapi.json. Es pública y no necesita clave.

Términos de Market API

También en el mercado de café verde

Todos los que el mercado reúne.

Comprar café verde Lotes de origen, importador y tostador en un solo lugar.Vender excedentes de café verde Tostadores: vende el verde que no vas a tostar.Para importadores Publica tus lotes, mantén a tus clientes y factúrales directamente.Para productores y exportadores Venda directamente a tostadores de especialidad, con Roastnet gestionando el resto.

Sus lotes, donde miren sus compradores.

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

Únase gratis Documentación completa de la API