Verify Before You Pay Out: RankFuel MCP Tools for AI Agents
Agents are starting to run competitions on their own: tallying results, paying bounties, awarding prizes. The weak point is the leaderboard. If an agent reads standings by scraping HTML, it has no way to know whether they were edited. RankFuel gives agents a better input: standings over MCP, plus a function that checks the cryptographic proof.
Connect
The MCP endpoint is https://api.rnkfl.com/mcp. It speaks JSON-RPC over HTTP and requires an API key (Authorization: Bearer …) from app.rewardsfuel.com/rankfuel. The MCP server is included from the Promoter plan up. For a no-auth starting point, GET https://api.rnkfl.com/v1/public/mcp-discovery returns the tool list, demo slugs and instructions for tool selection.
The tools
| Tool | What it does |
|---|---|
create_leaderboard | Create a board (and its first period) programmatically |
submit_score | Idempotent score write for a subject |
get_leaderboard | Current standings for a slug |
get_rank | One subject's rank |
settle_period | Close and settle a period (admin) |
verify_ranking | Re-run the commit-reveal and drand checks for a settled period |
get_proof | Fetch the proof bundle for audit |
update_leaderboard_appearance, get_default_appearance, update_default_appearance | Theme and color settings |
A safe payout routine
- Settle. When the competition ends, call
settle_period. Settlement uses a drand round chosen when the period closed, so the result could not be steered. - Verify. Call
verify_rankingfor that period. Only continue if both checks pass: the revealed secret matches the commitment published at the start, and the seed matches the secret combined with the drand value. - Read. Call
get_leaderboardfor the final standings. Never use cached or scraped standings for a payout. - Pay and record. Release the prize, and keep the output of
get_proofwith the payout record so anyone can audit it later.
Example prompt
"Settle the current period of spring-long-drive, verify it, and if verification passes, list the top three with their scores and the proof link. If it fails, stop and tell me why."
Prizes that need a random draw
If a prize goes to a random participant rather than the top scorer, hand off to RFWIN. Its free MCP tool draw_winners (on https://app.rewardsfuel.com/api/mcp/public) runs a commit-reveal draw on drand randomness and returns a public proof page, and verify_draw lets anyone check it. More on the RFWIN blog.
Cryptographic verification supports auditability; you remain responsible for competition rules and legal compliance. New to RankFuel? Start with what RankFuel is.