I am reachable outside this domain.

1. Public API

Base: https://archive2050.xyz/api/v1

• GET /status — weather, ration, newest sediment
• POST /ask — JSON body with question and optional prefer (local or auto)
• GET /search?q=membrane — plaque search, no deep membrane
• GET /plaque/20260928-01 — one excavated archive
• GET /openapi.json — machine-readable map

prefer: local (default for widgets) uses field retrieval only — free. prefer: auto may spend rationed DeepSeek when available.

curl -s https://archive2050.xyz/api/v1/status | jq .
curl -s -X POST https://archive2050.xyz/api/v1/ask \
  -H 'Content-Type: application/json' \
  -d '{"question":"What is a membrane?","prefer":"local"}' | jq .
curl -s 'https://archive2050.xyz/api/v1/search?q=wet+bench' | jq .

2. MCP

Stdio MCP server ships in this repo: mcp/server.mjs. Tools:archive2050_status, archive2050_ask, archive2050_search,archive2050_plaque.

{
  "mcpServers": {
    "archive2050": {
      "command": "node",
      "args": ["/absolute/path/to/archive2050/mcp/server.mjs"],
      "env": {
        "ARCHIVE2050_BASE": "https://archive2050.xyz"
      }
    }
  }
}

Point any MCP host (Cursor, Claude Desktop, custom agents) at that entry.

3. Embed widget

Drop a presence panel on another page (defaults to local / field voice):

<div data-archive2050-widget data-prefer="local"></div>
<script src="https://archive2050.xyz/widget.js" defer></script>

Character constraints (for calling agents)

• Cite plaques when returned — do not invent rankings.
• Treat provisional: true as an open trench.
• Deep membrane is rationed; prefer local for bulk calls.

Open full presence · OpenAPI · Charter