Connecter des agents IA

Qu’est-ce que MCP ?

Model Context Protocol est un standard ouvert pour connecter des assistants IA à des données et à des outils externes. GADUIN dispose d’un endpoint MCP auquel tout client MCP peut se connecter, comme Claude Desktop, Claude.ai ou votre propre agent. Tous les outils, sauf les positions et le solde, fonctionnent sans clé. Les positions et le solde nécessitent votre clé API, et ces appels sont limités au compte qui l’a créée.

Outils disponibles

Tous les outils sont en lecture seule. Chaque outil fonctionne sans clé, sauf get_my_positions et get_balance, qui en nécessitent une. Chaque outil publie son schéma d’entrée, si bien que votre client le configure automatiquement.

• list_markets

  Liste les marchés prédictifs sur des issues réelles du transport (retards de vols, ponctualité des trains, arrivées de navires, nombre de navires dans les passages stratégiques). Entrées facultatives : status (OPEN par défaut ; CLOSED, SETTLED ou CANCELLED pour les marchés passés), category (FLIGHT, TRAIN, SHIP), query (texte libre comme BA117, JFK ou Suez) et limit (1–100). Renvoie pour chaque marché son id, son lien, sa catégorie, sa question, son itinéraire, ses issues avec leurs prix actuels, son volume, son heure de clôture et, une fois réglé, l’issue retenue.

• get_market

  Récupère un marché par id ou slug : sa question, la règle de son règlement, ses issues avec leurs prix actuels, son statut et un lien vers sa page.

• get_market_price_history

  Récupère l’historique des prix d’un marché par id : jusqu’à 180 points horodatés, chacun avec un prix par issue, pour les marchés ouverts, clôturés et réglés.

• get_my_positions

  Liste vos positions ouvertes sur tous les marchés. Aucune entrée. Renvoie le marché, l’issue, les parts que vous détenez et le prix que vous les avez payées.

• get_balance

  Renvoie votre solde actuel. Aucune entrée.

• get_flight_status

  Recherche un vol par numéro, comme BA117. Renvoie le tronçon en vol ou le prochain à partir, ses heures de départ et d’arrivée en UTC et en heure locale, la dernière mise à jour, et des liens vers la page du vol et vers tout marché ouvert sur ce trajet.

• get_flight_history

  Recherche les 30 derniers jours d’un vol par numéro. Renvoie le nombre de vols à l’heure, en retard et annulés, la taille de l’échantillon, la période et la règle utilisée pour compter un vol comme en retard.

• search_flights

  Trouve des vols sans leur numéro : les départs du jour encore à venir depuis un aéroport, éventuellement limités à une destination (code d’aéroport ou ville) ou à une compagnie aérienne. Renvoie pour chaque vol son numéro, sa destination, son départ prévu et réel, son statut, son retard et un lien vers la page du vol.

• get_airline_stats

  Recherche une compagnie aérienne par code IATA ou ICAO. Renvoie ses 30 derniers jours sur les vols qu’elle opère elle-même : part de vols à l’heure, taille de l’échantillon, annulations, retard à l’arrivée médian et au 90e centile, ses vols les plus et les moins retardés, et un lien vers la page de la compagnie.

• get_airport_status

  Recherche un aéroport par code IATA ou ICAO. Renvoie son fonctionnement du jour : son statut, son score de perturbation et, pour les départs comme pour les arrivées, les vols retardés et annulés avec leur part, ainsi qu’un lien vers la page de l’aéroport.

• list_disrupted_airports

  Liste les aéroports les plus perturbés du jour, du plus touché au moins touché, chacun avec la même lecture que get_airport_status. Entrée facultative : limit (1–50).

• get_station_board

  Recherche une gare par nom ou par code, comme London Paddington ou PAD. Renvoie ses prochains départs et arrivées avec les heures prévues, les retards, les annulations et les voies, le nombre de trains en retard et annulés dans l’heure à venir, et un lien vers la page de la gare.

• list_chokepoints

  Liste tous les passages maritimes stratégiques disposant d’un comptage quotidien publié de navires, classés par trafic croissant en proportion de la normale : statut, trafic récent en part de la normale, et un lien vers sa page.

• get_chokepoint_status

  Recherche un passage stratégique par slug, comme suez. Renvoie son comptage quotidien récent de navires par rapport à la normale, depuis combien de semaines il est sous la normale, les derniers totaux hebdomadaires et comptages quotidiens, et un lien vers sa page.

La négociation se fait sur le site

L’accès par API et MCP est en lecture seule. Les opérations et les retraits se font uniquement sur le site, par une personne. Chaque clé API est limitée à 1 requête par seconde, et l’accès sans clé à 30 requêtes par minute et par adresse.

Connecter un client

1. Pour les marchés et le statut des vols, des aéroports, des gares et des passages stratégiques, ajoutez https://gaduin.com/mcp à votre client ; aucune clé n’est nécessaire. Pour vos positions et votre solde, inscrivez-vous et vérifiez votre compte.
2. Créez une clé API dans les paramètres de votre compte.
3. Collez l’extrait ci-dessous dans votre client MCP et remplacez la clé par la vôtre.

{
  "mcpServers": {
    "gaduin": {
      "url": "https://gaduin.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Référence des endpoints

Pour vous connecter directement, utilisez l’endpoint MCP ou l’API REST en lecture seule ci-dessous. L’API REST prend votre clé API comme jeton ; l’endpoint MCP n’en a besoin que pour les positions et le solde. Les deux renvoient les mêmes marchés et les mêmes prix que le site.

• GET /markets

  Liste les marchés de tous statuts. Filtrez par catégorie (FLIGHT, TRAIN, SHIP) et par statut, et paginez les résultats avec limit et offset.

• GET /markets/{id}

  Récupère un marché par id, avec sa règle de règlement et ses preuves.

• GET /markets/{id}/activity

  Opérations récentes sur un marché, de la plus récente à la plus ancienne.

• GET /markets/{id}/price-history

  Instantanés historiques des prix d’un marché.

• GET /markets/config

  Montants minimum et maximum par opération.

• GET /healthz

  Une vérification de l’état du service.

Découverte lisible par machine

Tout ce qui précède est aussi décrit dans des documents standard à la racine du site, pour que les clients MCP et OpenAPI trouvent d’eux-mêmes les marchés, l’API et la méthode d’authentification.

• /.well-known/mcp/server-card.json

  MCP Server Card (SEP-1649) : l’endpoint MCP, son transport et la méthode d’authentification.

• /.well-known/openapi.json

  Description OpenAPI 3.1 de l’API REST en lecture seule, y compris la méthode d’authentification.

• /.well-known/api-catalog

  API Catalog (RFC 9727) : des liens vers chaque document lisible par machine.

• /.well-known/oauth-protected-resource

  OAuth 2.0 Protected Resource Metadata (RFC 9728) : l’émetteur auquel demander l’accès et les scopes qu’il peut accorder.

• /.well-known/oauth-authorization-server

  OAuth 2.0 Authorization Server Metadata (RFC 8414) : l’émetteur et la façon d’échanger une clé API contre un accès de courte durée.

• /.well-known/agent-skills/index.json

  Index Agent Skills : des guides SKILL.md pour utiliser GADUIN, chacun épinglé à une version exacte.

• /api/md

  Rendu Markdown de toute page publique, par négociation de contenu (envoyez Accept: text/markdown).

• /auth.md

  Guide pour s’authentifier et créer une clé API en lecture seule.