RoastnetRoastnet

API du marché et MCP

API et intégrations: connectez votre stock ou votre IA au marché du café vert.

Gardez vos lots de café vert sur Roastnet alignés avec votre système, traitez commandes et demandes d’échantillons à l’arrivée, et laissez un assistant IA faire le même travail sur votre compte.

API REST

Une clé, toute la partie vente.

Créez une clé dans votre console Roastnet et envoyez‑la comme jeton Bearer. L’API couvre lots, commandes, échantillons, offres et un flux d’événements, avec des webhooks pour vous signaler chaque changement dès qu’il survient.

curl https://network.roastnet.ai/api/market/v1/lots \
  -H "Authorization: Bearer rnk_YOUR_KEY"
  • 01Lister, synchroniser, mettre à jour et retirer des lots selon votre propre référence.
  • 02Confirmer, refuser et marquer les commandes comme expédiées et livrées.
  • 03Voir les demandes d’échantillons et marquer les envois comme effectués.
  • 04Jusqu’à 120 requêtes par minute et par clé, une réponse 429 indique quand réessayer.

Agents IA (MCP)

Connectez votre assistant IA.

Roastnet exécute un serveur Model Context Protocol pour le marché du café vert. Connectez tout client MCP, et votre assistant peut parcourir le marché, lister, ajouter, mettre à jour et retirer vos lots par référence, lire vos commandes, offres et demandes d’échantillons, et marquer un échantillon comme envoyé, selon les mêmes règles que l’API.

  1. Rejoignez gratuitement le marché du café vert, ou ouvrez votre console Roastnet.
  2. Ouvrez Connect agent et créez un jeton pour votre assistant.
  3. Ajoutez le serveur ci-dessous à votre client MCP et collez le jeton.

Configuration du client MCP (JSON)

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

Ou depuis un client en ligne de commande

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

Remplacez YOUR_TOKEN par le jeton créé dans Connect agent. Les jetons peuvent être révoqués à tout moment au même endroit.

Pour les machines

Découvrable par conception.

Agents et crawlers peuvent tout trouver seuls: la fiche du serveur MCP à /.well-known/mcp.json, un aperçu en texte brut à /llms.txt et le document OpenAPI lié depuis cette page.

Questions

Ce que l'on nous demande.

Qui peut utiliser l’API du marché ?
Toute entreprise qui vend sur le marché du café vert Roastnet, y compris importateurs, torréfactions et exportateurs, une fois inscrite et après avoir créé une clé dans sa console.
Comment fonctionne l’authentification ?
L’API REST utilise une clé d’API envoyée comme jeton Bearer. Le serveur MCP utilise un jeton que vous créez dans Connect agent, également envoyé comme jeton Bearer.
Où se trouve la spécification OpenAPI ?
À network.roastnet.ai/api/market/v1/openapi.json. Elle est publique et ne requiert aucune clé.

Conditions de l’API du marché

Vos lots, partout où vos acheteurs regardent.

Rejoignez gratuitement le marché du café vert, créez une clé et connectez votre système cet après-midi.