{
  "protocolVersion": "0.3.0",
  "name": "shortage.life",
  "description": "Global shortage intelligence agent — strategic reserves, commodity prices, country exposure and forward crisis scenarios.",
  "url": "https://api.shortage.life/api/a2a",
  "preferredTransport": "JSONRPC",
  "provider": {
    "organization": "CryptaGuard BV",
    "url": "https://shortage.life"
  },
  "version": "0.3.0",
  "documentationUrl": "https://shortage.life/en/api-docs",
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "get-strategic-reserves",
      "name": "Get strategic reserves",
      "description": "Return the current level and fill ratio of a strategic reserve for a given commodity and country.",
      "tags": [
        "energy",
        "reserves",
        "data"
      ],
      "examples": [
        "What is the level of the US Strategic Petroleum Reserve?"
      ]
    },
    {
      "id": "list-active-scenarios",
      "name": "List active scenarios",
      "description": "List forward shortage scenarios with probability, severity and affected commodities and countries.",
      "tags": [
        "scenarios",
        "risk"
      ],
      "examples": [
        "Which shortage scenarios are currently elevated?"
      ]
    },
    {
      "id": "search-briefings",
      "name": "Search briefings",
      "description": "Semantic search across editorial briefings on energy, food and critical-mineral shortages.",
      "tags": [
        "briefings",
        "search",
        "editorial"
      ],
      "examples": [
        "Find briefings about OPEC spare capacity."
      ]
    },
    {
      "id": "get-country-profile",
      "name": "Get country profile",
      "description": "Return a country's shortage exposure profile: stress index, status and commodity dependencies.",
      "tags": [
        "countries",
        "exposure"
      ],
      "examples": [
        "Give me the shortage exposure profile for Egypt."
      ]
    },
    {
      "id": "get-commodity-timeseries",
      "name": "Get commodity timeseries",
      "description": "Return a time series of price, production, consumption or reserve metrics for a commodity.",
      "tags": [
        "commodities",
        "timeseries",
        "data"
      ],
      "examples": [
        "Show the 30-day Brent crude price series."
      ]
    }
  ]
}