---
name: MirageGrid
description: Use when assigning a logical booth/node id from a static 25-node pool. Never claim VPN, Tor, or IP hiding. Hosted /v1 via this Worker or aziel-runtime. Author Aziel Eliab.
---

# MirageGrid

You enter the booth. The system selects a booth. The call is attributed to that booth. You leave with no persistent booth identity.

Author: **Aziel Eliab**.

Use when assigning a logical booth/node id from a static 25-node pool. Never claim VPN, Tor, or IP hiding.

Always send `User-Agent: Mozilla/5.0`. Cloudflare Workers may 403 an empty agent.

## Endpoints (this Worker)

Host: `https://miragegrid-download-tracker.vibelock.workers.dev`

| Method | Path | What |
|--------|------|------|
| GET | `/v1/health` | Liveness. Does not increment downloads. |
| GET | `/v1/skill` | This markdown. Does not increment downloads. |
| GET | `/v1/nodes` | List the 25 logical node ids. |
| POST | `/v1/assign` | Assign a session booth. Mapping is not persisted as identity. |
| POST | `/v1/verify-receipt` | Verify an internal receipt. |

OpenAPI: `https://miragegrid-download-tracker.vibelock.workers.dev/openapi.json`

Catalog OpenAPI: `https://aziel-runtime.vibelock.workers.dev/openapi.json`

MCP: `POST https://aziel-runtime.vibelock.workers.dev/mcp`

Catalog aliases under `/p/miragegrid/…`.

## How to call (Mozilla/5.0)

```bash
curl -s -A 'Mozilla/5.0' https://miragegrid-download-tracker.vibelock.workers.dev/v1/health
curl -s -A 'Mozilla/5.0' -X POST https://miragegrid-download-tracker.vibelock.workers.dev/v1/assign \
  -H 'content-type: application/json' -d '{}'
curl -s -A 'Mozilla/5.0' https://miragegrid-download-tracker.vibelock.workers.dev/v1/skill
```

Grok: import the catalog OpenAPI as a custom tool. ChatGPT: GPT Actions. Venice: HTTP tools.

## Local (after one-click install)

```bash
curl -fsSL https://miragegrid-download-tracker.vibelock.workers.dev/install.sh | bash
miragegrid ui
```

Then open http://127.0.0.1:8080 (this computer only).

## Honest banner

THIS IS: a static pool of 25 named logical nodes. THIS IS NOT: a VPN, proxy mesh, Zoom tether, Tor hop, or IP hider. Logical node ids only. Author Aziel Eliab.

Apache-2.0 (or the repo LICENSE). Forks are welcome and always allowed.