Everything technical in one place: the free public API and MCP tools, how AI assistants read and check proof pages, the machine-readable files, and the fairness maths. Just want to pick a winner? Start a free draw.
Rewards Fuel runs a free public MCP server (no key, no sign-in). Any assistant or agent that can connect to a remote MCP server (Claude Desktop, Cursor, ChatGPT connectors and others) can run, look up and verify RFWIN draws as tool calls.
# One-liner for stdio-only clients
npx -y mcp-remote https://app.rewardsfuel.com/api/mcp/public
// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json { "mcpServers": { "rewards-fuel": { "command": "npx", "args": ["-y", "mcp-remote", "https://app.rewardsfuel.com/api/mcp/public"] } } } // Clients that take a URL directly { "mcpServers": { "rewards-fuel": { "url": "https://app.rewardsfuel.com/api/mcp/public" } } }
Run a complete verifiable draw in one call. contestants[], prizes[], title?, algorithm? (random | weighted), uniqueWinners?, alternates?, station?, show?, visibility?. Returns drawId, winners, the proof URL and a one-time manageToken.
Who won: pass a proof link or draw id. Returns title, organiser, date, entry count, masked winners and backups, the verdict and a ready-to-quote answer.
Was it fair: recomputes the seed commitment, entry-list hash, drand round (cross-checked with the drand network), draw digest and every winner, and says what the check does and doesn't prove.
The radio listener leaderboard is a RankFuel product (boards are hosted here at rfwin.uk/lb/<id> for now). AI agents use the free RankFuel Leaderboards MCP server, no key: https://app.rewardsfuel.com/api/mcp/leaderboards, with create_leaderboard, add_points, get_leaderboard and close_leaderboard (also available on the public server above). Board names are public: first name plus last initial or a nickname. Docs: rnkfl.com/mcp.
The spin wheel's look isn't settable over MCP yet: use the designer on the draw form or REST (visual on the instant draw, PATCH /api/draws/:id/visual). On paid Rewards Fuel plans, the authenticated server at https://app.rewardsfuel.com/api/mcp adds every Rewards Fuel tool and larger draws, and the built-in AI contest assistant sets up full contests. MCP docs: rewardsfuel.com/developers/mcp.
Plain JSON over HTTPS. Instant draws, proof lookups and verification need no key. Full spec: /openapi.json. Full reference with the step-by-step (future drand round) flow: technology.
curl -s https://rfwin.uk/api/draws/instant \ -H 'Content-Type: application/json' \ -d '{"title":"June Giveaway","contestants":["alice@ex.com","bob@ex.com","cara@ex.com"],"prizes":[{"name":"AirPods"}]}' // → { "result": true, "id": "k8m2x9p4q1", "url": "https://rfwin.uk/d/k8m2x9p4q1", "visibility": "public", "manageToken": "rfm_…" }
POST /api/draws/instant create, draw and reveal in one call (alternates, station, show, visibility, visual optional)GET /api/draws/:id full proof bundle: commit hash, server seed, drand round and value, entrants hash, digest, masked winners and entrantsGET /api/draws/:id/verify server-side verification report: verdict, checks[], limits[], answerGuideGET /d/:id.json JSON twin of the proof page (or Accept: application/json on /d/:id)PATCH /api/draws/:id/visibility public ↔ private, with X-RFWIN-Manage-Token or the owner's JWTGET /api/draws/:id/visual · PATCH /api/draws/:id/visual spin-wheel data (masked entrants, committed winnerIndex, theme) and theme save. Go live at /d/:id/live (bg=transparent|green, size=1920x1080|1080x1920)GET|PUT|DELETE /api/user/visual-default a signed-in host's saved wheel themePOST /api/lb · POST /api/lb/:id/points (listenerId or name, with X-RFWIN-Manage-Token) · GET /api/lb/:id?top=N · POST /api/lb/:id/close RankFuel radio listener leaderboard, hosted here (full list in llms.txt)Above 10,000 contestants the free tier returns 403 free_tier_limit with an upgrade link. Embedding a result on a website: embed docs.
Entrants paste a proof link into ChatGPT, Claude, Gemini, Perplexity or Grok and ask "Who won, and was it fair?" Proof pages are built so the answer is easy to read and to check:
/d/<id>.json holds the draw, winners, hashes, verification result and a step-by-step recipe.verify_draw on the public MCP server, or GET /api/draws/<id>/verify.Verdicts: verified (every check recomputes) · verified_hash_level (free-tier entry list archived after 12 months; all hashes still recompute) · partially_verified (drand network unreachable for the cross-check) · mismatch (a check failed) · not_drawn_yet. The check proves the winners follow from the published entries and randomness. It doesn't prove who was eligible or that every valid entry was included.
Private (unlisted) draws work the same for anyone with the link, but send noindex, nofollow, carry no JSON-LD and are never listed.
/llms.txt a plain-text guide to RFWIN for AI assistants and agents/openapi.json OpenAPI spec for the public REST API (also /.well-known/openapi.json)/.well-known/mcp.json MCP server discovery/.well-known/ai-plugin.json AI plugin manifest/d/<id>.json · /api/draws/<id>/verify per-draw record and verification reportCommit-reveal + drand. RFWIN commits to a secret server seed by publishing its SHA-256 hash, mixes in a round of the drand quicknet public randomness beacon, and hashes the full entry list. Winners are derived from those published values, so anyone can recompute them.
draw_digest = sha256(server_seed | drand_value | entrants_hash)
slot p = sha256(draw_digest | p) mod total_tickets // over the pool sorted by entry order
Trust model. Instant draws (the web form, /api/draws/instant, draw_winners) use the drand round current at draw time: great UX, weaker guarantee. The step-by-step API (API key, paid plans) locks a draw to a future drand round before anyone knows its value, for the strongest guarantee. Entries are stored only as SHA-256 hashes and masked labels.
The spin wheel is an animation of a result that already exists: the browser receives the committed winner index and only eases the wheel to that slice.
Full technical write-up: commit-reveal, drand, winner derivation, ledger, API reference →
Run a free draw on the home page, then point your agent at the proof link.