post_v1_admin_referrals_sweep

Qualify-checks every pending referral and grants the ones that now qualify.

SuperAdmin only, fail-closed. This is the cron path: a referee QUALIFIES once they have made metered spend — the honest signal that they actually used the product rather than merely claiming a welcome grant — and qualifying grants the referrer and the referee their bonuses in one latched step.

The grant is backed against the platform reserve fund before it is latched, so an empty fund leaves the referral honestly pending rather than minting unbacked credit, and the latch makes it at-most-once: this sweep, a concurrent sweep and the lazy check on GET /v1/referrals can never double-pay. One pass is bounded, so a large backlog drains over several runs instead of wedging one request.

It reads nothing from the caller — the counters it returns are the whole result.

Arguments

This tool declares no arguments. Call it with an empty arguments object.

Call it

A tools/call carries its arguments in one flat object. This tool declares none, so the object is empty.

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "post_v1_admin_referrals_sweep",
         "arguments": {}
       }
     }'

tools/list needs no credential; tools/call does — called without one the door answers HTTP 200 with a JSON-RPC result whose isError is set and whose text says what was missing. How to get a key →

The operation behind it

The same capability over plain HTTP is in the cloud API reference, on https://api.hanzo.ai.

All 834 tools · The door · API reference

Generated from tools/list on https://api.hanzo.ai/v1/mcp — 834 tools captured 2026-08-01 (this build read the vendored copy; the door was unreachable).