---
name: MirageGrid
description: Use when assigning a session node, routing peers, or installing MirageGrid. Not a VPN and not an anonymity network. Author Aziel Eliab.
---

# MirageGrid

You enter the booth. The mesh selects a booth and builds a circuit. You leave with no persistent booth identity.

Author: **Aziel Eliab**.

**THIS IS:** ephemeral control-plane node/circuit assignment (25 named peers, receipts, shortest-path maps).

**THIS IS NOT:** a VPN, an anonymity network, a hosted hop, a crime tool, a log-wipe, or a guarantee against a global adversary. Hosted `/v1` does not increment downloads.

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 mesh nodes. |
| GET | `/v1/mesh` | Topology, adjacency, default listen ports. |
| POST | `/v1/route` | Shortest peer path between two nodes. |
| POST | `/v1/assign` | Assign a session circuit (entry + hops + path). |
| POST | `/v1/circuit` | Build circuit hops from entropy/timestamp (or fresh). |
| POST | `/v1/verify-receipt` | Verify an internal receipt. |

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

Catalog OpenAPI: `https://godlock.uk/runtime/openapi.json`

MCP: `POST https://godlock.uk/runtime/mcp`

## 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/mesh
```

Works with any OpenAPI- or MCP-capable assistant: ChatGPT (GPT Actions / OpenAI), Grok (xAI), Venice, Claude (Anthropic), Cursor (MCP), Glama (MCP), Perplexity, Microsoft Copilot / Bing, Google Gemini / Vertex, Mistral, Meta AI, Apple Intelligence surfaces, Amazon Q tooling, DuckAssist, You.com, Cohere, and other MCP/OpenAPI-capable assistants.

Import notes: ChatGPT — GPT Actions (OpenAPI URL). Grok — custom tool from OpenAPI. Venice — HTTP tools. Cursor / Glama — MCP catalog. Claude and other OpenAPI/MCP clients — same OpenAPI document or MCP catalog.

## Local (after one-click install)

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

Then open http://127.0.0.1:8080 (loopback console). Hosted MirageGrid is not a VPN.

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