$_MCP SERVIDOR

Un servidor Model Context Protocol público. Conecte cualquier agente de IA compatible con MCP —Claude, Cursor y otros— y déjelo consultar directamente los datos de shortage.life: reservas estratégicas, precios, escenarios, perfiles de países, incidentes y más.

[ 01 ] $_QUÉ ES EL MCP

El Model Context Protocol es un estándar abierto que permite a los asistentes de IA invocar herramientas externas. shortage.life expone su conjunto de datos como diez herramientas MCP de solo lectura, mediante JSON-RPC 2.0. Sin clave, sin cuenta, sin coste: los mismos datos con licencia CC-BY-4.0 que la API pública.

[ 02 ] $_CONEXIÓN

El servidor habla JSON-RPC 2.0 sobre HTTP POST (MCP revisión 2024-11-05). Añádalo a su cliente como un servidor 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 ] $_HERRAMIENTAS · 10 de solo lectura

Cada herramienta corresponde a una consulta de datos. Los agentes las descubren mediante la llamada tools/list y las ejecutan mediante tools/call.

tool	params	returns
get_reserve	commodity, country	Reserva estratégica actual de una materia prima en un país.
get_price	commodity	Precio al contado actual de una materia prima.
compare_countries	commodity, countries[]	Compara las reservas estratégicas de una materia prima entre varios países.
list_scenarios	status?	Lista los escenarios de escasez prospectivos, filtrables por estado.
search_briefings	query, lang?	Búsqueda por palabras clave en los informes editoriales publicados.
get_country_profile	iso	Perfil de país completo: índice de estrés, región y reservas.
list_incidents	since?, type?	Incidentes geopolíticos en infraestructuras energéticas, desde una fecha opcional.
list_market_statements	since?	Declaraciones políticas capaces de mover los mercados, desde una fecha opcional.
list_bankruptcies	status?	Datos de quiebras de empresas por país.
get_food_prices	—	Precios actuales de las materias primas alimentarias y sus series semanales.

[ 04 ] $_EJEMPLO · llamadas JSON-RPC

Enumere las herramientas y luego ejecute una. No se requiere autenticación.

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

El servidor MCP forma parte de una capa de legibilidad para agentes de IA. Los archivos de descubrimiento la declaran de forma legible por máquina.

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