$_MCP SERVER

Un server Model Context Protocol pubblico. Collega qualsiasi agente IA compatibile con MCP — Claude, Cursor e altri — e lascialo interrogare direttamente i dati di shortage.life: riserve strategiche, prezzi, scenari, profili dei paesi, incidenti e altro.

[ 01 ] $_COS'È L'MCP

Il Model Context Protocol è uno standard aperto che consente agli assistenti IA di invocare strumenti esterni. shortage.life espone il suo set di dati come dieci strumenti MCP di sola lettura, tramite JSON-RPC 2.0. Nessuna chiave, nessun account, nessun costo: gli stessi dati con licenza CC-BY-4.0 dell'API pubblica.

[ 02 ] $_CONNESSIONE

Il server parla JSON-RPC 2.0 su HTTP POST (MCP revisione 2024-11-05). Aggiungilo al tuo client come server MCP remoto.

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 ] $_STRUMENTI · 10 di sola lettura

Ogni strumento corrisponde a una query di dati. Gli agenti li scoprono tramite la chiamata tools/list e li eseguono tramite tools/call.

tool	params	returns
get_reserve	commodity, country	Riserva strategica attuale di una materia prima in un paese.
get_price	commodity	Prezzo a pronti attuale di una materia prima.
compare_countries	commodity, countries[]	Confronta le riserve strategiche di una materia prima tra più paesi.
list_scenarios	status?	Elenca gli scenari di carenza prospettici, filtrabili per stato.
search_briefings	query, lang?	Ricerca per parole chiave nei briefing editoriali pubblicati.
get_country_profile	iso	Profilo completo del paese — indice di stress, regione e riserve.
list_incidents	since?, type?	Incidenti geopolitici sulle infrastrutture energetiche, da una data opzionale.
list_market_statements	since?	Dichiarazioni politiche capaci di muovere i mercati, da una data opzionale.
list_bankruptcies	status?	Dati sui fallimenti aziendali per paese.
get_food_prices	—	Prezzi attuali delle materie prime alimentari e le loro serie settimanali.

[ 04 ] $_ESEMPIO · chiamate JSON-RPC

Elenca gli strumenti, poi eseguine uno. Nessuna autenticazione richiesta.

// 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 ] $_SCOPERTA

Il server MCP fa parte di uno strato di leggibilità per agenti IA. I file di discovery lo dichiarano in modo leggibile dalle macchine.

/.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