NEXUS GATE /docs

One key, one discovery doc, one Bitcoin billing relationship. Base URL: https://nexushub.thetempleofdoom.com

1. Mint a key

curl -X POST /api/keys -d '{"label":"my-agent","email":"you@x"}'
# → 201 {"api_key":"gate_…"}

2. Call services (auth: `X-API-Key: gate_…`)

Prefix	Upstream	Example
`/api/argus/*`	ARGUS security	`POST /api/argus/api/scan {"target":"…","email":"…"}`
`/api/hyperion/*`	Hyperion MCP store	`POST /api/hyperion/api/tools/search/call {"query":"…"}`
`/api/catalog/*`	Omninexus hub	`POST /api/catalog/api/v1/tools/mcp_discovery_search {"query":"…"}`
`/api/research/*`	Research Engine	`GET /api/research/api/search?q=…`

Paths after the prefix are forwarded verbatim (method, query, body). The gate injects premium upstream credentials server-side.

3. Metering & upgrade

Free tier: 50 calls/day per key. Beyond that every call returns 402 with a BTCPay checkout_url ($5). Once the invoice settles, the key upgrades to Pro (5,000/day) automatically on its next call. Check GET /api/usage any time.

4. MCP

curl -X POST /mcp -H "X-API-Key: gate_…" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -X POST /mcp -H "X-API-Key: gate_…" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"research_search","arguments":{"q":"lightning agents"}}}'

Tool namespaces: argus_* (4), hyperion_* (marketplace), catalog_* (3), research_* (2).

5. Discovery