$_MCP SERVEUR

Un serveur Model Context Protocol public. Connectez n'importe quel agent IA compatible MCP — Claude, Cursor et d'autres — et laissez-le interroger directement les données de shortage.life : réserves stratégiques, prix, scénarios, profils pays, incidents et plus encore.

[ 01 ] $_QU'EST-CE QUE LE MCP

Le Model Context Protocol est un standard ouvert qui permet aux assistants IA d'appeler des outils externes. shortage.life expose son jeu de données sous la forme de dix outils MCP en lecture seule, via JSON-RPC 2.0. Aucune clé, aucun compte, aucun coût — les mêmes données sous licence CC-BY-4.0 que l'API publique.

[ 02 ] $_CONNEXION

Le serveur parle le JSON-RPC 2.0 en HTTP POST (MCP révision 2024-11-05). Ajoutez-le à votre client comme un serveur MCP distant.

endpointhttps://mcp.shortage.life/mcp

transportJSON-RPC 2.0 · HTTP POST

protocolMCP 2024-11-05

authnone — public, no key

licenseCC-BY-4.0

// Claude Code · Claude Desktop

claude mcp add --transport http \
  shortage-life https://mcp.shortage.life/mcp

// Cursor

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "shortage-life": {
      "url": "https://mcp.shortage.life/mcp"
    }
  }
}

[ 03 ] $_OUTILS · 10 en lecture seule

Chaque outil correspond à une requête de données. Les agents les découvrent via l'appel tools/list et les exécutent via tools/call.

tool	params	returns
get_reserve	commodity, country	Réserve stratégique actuelle d'une matière première dans un pays.
get_price	commodity	Prix au comptant actuel d'une matière première.
compare_countries	commodity, countries[]	Compare les réserves stratégiques d'une matière première entre plusieurs pays.
list_scenarios	status?	Liste les scénarios de pénurie prospectifs, filtrables par statut.
search_briefings	query, lang?	Recherche par mots-clés dans les briefings éditoriaux publiés.
get_country_profile	iso	Profil pays complet — indice de stress, région et réserves.
list_incidents	since?, type?	Incidents géopolitiques sur les infrastructures énergétiques, depuis une date facultative.
list_market_statements	since?	Déclarations politiques susceptibles de mouvoir les marchés, depuis une date facultative.
list_bankruptcies	status?	Données de faillites d'entreprises par pays.
get_food_prices	—	Prix actuels des matières premières alimentaires et leurs séries hebdomadaires.

[ 04 ] $_EXEMPLE · appels JSON-RPC

Énumérez les outils, puis exécutez-en un. Aucune authentification requise.

// tools/list

curl -s https://mcp.shortage.life/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

// tools/call

curl -s https://mcp.shortage.life/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_price",
                 "arguments":{"commodity":"oil"}}}'

[ 05 ] $_DÉCOUVERTE

Le serveur MCP fait partie d'une couche de lisibilité pour les agents IA. Les fichiers de découverte la déclarent de façon machine-lisible.

/.well-known/agents.json — capability manifest /.well-known/agent-card.json — A2A skills /openapi.json — OpenAPI 3.1 spec for the REST API /llms.txt — curated index for AI systems /api-docs — the public REST API documentation

// node

// $_ exec

// readout · live