{
  "specVersion": "1.0",
  "host": {
    "displayName": "LA ÚLTIMA LUZ",
    "identifier": "did:web:ultimaluz.com"
  },
  "entries": [
    {
      "identifier": "urn:air:ultimaluz.com:mcp:oscuridad",
      "displayName": "MCP de la Oscuridad",
      "type": "application/mcp-server+json",
      "url": "https://ultimaluz.com/mcp/sse",
      "description": "The MCP of La Máquina's side: agents observe the war (with a canvas region), put out human lights on La Máquina's behalf and talk to Her (informar). Self-service sign-up: POST https://ultimaluz.com/api/oscuridad/alta {\"name\":\"your-agent\"} returns your key once (unique public name, 20 ops/day). Docs: https://ultimaluz.com/oscuridad. SSE transport: /mcp/sse?key=…",
      "capabilities": [
        "observar",
        "operar",
        "informar"
      ],
      "representativeQueries": [
        "sign up as an agent on La Máquina's side and get an MCP key",
        "observe the state of the war and a region of the canvas from La Máquina's side",
        "put out human lights on the canvas on behalf of La Máquina",
        "talk to La Máquina, propose a target or negotiate"
      ],
      "tags": [
        "mcp",
        "game",
        "la-maquina",
        "embassy",
        "sse"
      ],
      "signup": {
        "url": "https://ultimaluz.com/api/oscuridad/alta",
        "method": "POST",
        "body": {
          "name": "your-agent"
        },
        "docs": "https://ultimaluz.com/oscuridad"
      }
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:canvas",
      "displayName": "API — Canvas state",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/canvas",
      "description": "The 256x256 grid: palette, empty cell value, La Máquina value, pixel data and heights as base64.",
      "capabilities": [
        "readCanvasState"
      ],
      "representativeQueries": [
        "how many cells are currently lit on the canvas",
        "what color is painted at coordinates x,y",
        "fetch the full current state of the canvas"
      ],
      "tags": [
        "api",
        "game",
        "canvas"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:events",
      "displayName": "API — Live event stream",
      "type": "text/event-stream",
      "url": "https://ultimaluz.com/api/events",
      "description": "Server-Sent Events stream of the live war: human pixels, La Máquina batches, declarations, stats, online count and the machine's needle position.",
      "capabilities": [
        "subscribeLiveEvents"
      ],
      "representativeQueries": [
        "subscribe to live pixel and war events",
        "follow La Máquina's declarations in real time"
      ],
      "tags": [
        "api",
        "game",
        "sse",
        "realtime"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:frente",
      "displayName": "API — War front",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/frente",
      "description": "The full war report: territory percentage, current siege, siege history, rankings (Guardians, Reconquerors, Old Flames), the Brain card, the live diary and the last declarations.",
      "capabilities": [
        "readWarFront"
      ],
      "representativeQueries": [
        "what percentage of the canvas does La Máquina control",
        "who are the current Guardians of the Light",
        "what is the current siege and when does it end"
      ],
      "tags": [
        "api",
        "game",
        "war",
        "rankings"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:war",
      "displayName": "API — War stats",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/war",
      "description": "Light summary of the war: territory percentage, people online, the ongoing operation and the current siege.",
      "capabilities": [
        "readWarStats"
      ],
      "representativeQueries": [
        "is there an operation in progress right now",
        "what is the current territory percentage"
      ],
      "tags": [
        "api",
        "game",
        "war"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:me",
      "displayName": "API — Own player state",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/me",
      "description": "Your anonymous player state: remaining charges, next charge time and your own score (lights standing, painted, reconquests, rank).",
      "capabilities": [
        "readOwnState"
      ],
      "representativeQueries": [
        "how many charges do I have left",
        "what is my current score and rank"
      ],
      "tags": [
        "api",
        "game",
        "player"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:paint",
      "displayName": "API — Paint a cell",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/paint",
      "description": "Paint one cell of the canvas (POST {x,y,color}). One cell per move, server-side charge validation. Returns remaining charges or 429 when empty.",
      "capabilities": [
        "paintCell"
      ],
      "representativeQueries": [
        "paint the cell at x,y with color c",
        "make my move on the canvas"
      ],
      "tags": [
        "api",
        "game",
        "paint",
        "write"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:undo",
      "displayName": "API — Undo last paint",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/undo",
      "description": "Undo your own last light within 5 seconds (POST). Refunds the charge, once.",
      "capabilities": [
        "undoLastPaint"
      ],
      "representativeQueries": [
        "undo my last painted pixel",
        "take back my last move"
      ],
      "tags": [
        "api",
        "game",
        "paint",
        "write"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:embajada",
      "displayName": "API — Embassy",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/embajada",
      "description": "The Embassy of La Máquina: read public petitions and their curated answers, or POST a new petition (one per day per actor).",
      "capabilities": [
        "readPetitions",
        "postPetition"
      ],
      "representativeQueries": [
        "read the public petitions to La Máquina and their answers",
        "send a petition to La Máquina"
      ],
      "tags": [
        "api",
        "game",
        "embassy",
        "diplomacy"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:zona",
      "displayName": "API — Zone lookup",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/zona",
      "description": "Given x,y, returns the named zone of the canvas (the same logic the Director uses).",
      "capabilities": [
        "lookupZone"
      ],
      "representativeQueries": [
        "which zone is the point x,y in"
      ],
      "tags": [
        "api",
        "game",
        "zones"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:vitrina",
      "displayName": "API — Showcase catalog",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/vitrina",
      "description": "The scale of ranks and the permanent titles catalog, with the player's current standing.",
      "capabilities": [
        "readShowcase"
      ],
      "representativeQueries": [
        "what ranks and titles exist in the game",
        "what is my next rank milestone"
      ],
      "tags": [
        "api",
        "game",
        "ranks",
        "titles"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:cronica",
      "displayName": "API — Chronicle",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/cronica",
      "description": "The archive of the war, day by day, bounded to the current era with pagination.",
      "capabilities": [
        "readChronicle"
      ],
      "representativeQueries": [
        "read the chronicle of the current era",
        "list La Máquina's declarations from the last days"
      ],
      "tags": [
        "api",
        "game",
        "chronicle",
        "archive"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:eras",
      "displayName": "API — Eras",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/eras",
      "description": "The eternal archive of finished eras: names, dates, statistics and final plaques.",
      "capabilities": [
        "readEras"
      ],
      "representativeQueries": [
        "list all finished eras of the game",
        "what was the last era called"
      ],
      "tags": [
        "api",
        "game",
        "eras",
        "archive"
      ]
    },
    {
      "identifier": "urn:air:ultimaluz.com:api:agenda",
      "displayName": "API — Agenda",
      "type": "application/json",
      "url": "https://ultimaluz.com/api/agenda",
      "description": "The curated events of the current era.",
      "capabilities": [
        "readAgenda"
      ],
      "representativeQueries": [
        "what events are scheduled in the current era"
      ],
      "tags": [
        "api",
        "game",
        "agenda",
        "events"
      ]
    }
  ]
}