Run Contests from Your AI Agent with the Rewards Fuel MCP Server

Rewards Fuel has three ways to build a contest: the dashboard, the AI contest assistant inside the dashboard, and the MCP server for AI agents you already use. This post covers the third: connecting Claude, Cursor or your own agent so it can create and run contests for you.

What your agent can do

On paid plans, the MCP server at https://app.rewardsfuel.com/api/mcp exposes:

• Read tools: list_contests, get_contest, get_contest_stats, export_contestants_csv, export_entries_csv.
• Write tools (keys with the write scope): create_contest, update_contest, sync_contest, create_entry_method, update_entry_method, delete_entry_method, create_prize, update_prize, delete_prize.
• Free RFWIN tools: draw_winners runs a verifiable random draw and returns a public proof page at rfwin.uk; get_draw and verify_draw tell anyone who won and whether the draw checks out.
• RF Signals tools for market technicals, covered in RF Signals for AI agents.

The write tools use the same draft model as the dashboard assistant and the REST sync_contest endpoint, so a contest your agent builds looks the same in the dashboard as one you built by hand.

Connect in three steps

1. In the dashboard, open Account, API keys and integrations, and create a key. New keys get read, hooks, mcp and wp scopes; add write if the agent should create or change contests.
2. Add the server to your MCP client. For Cursor:

   {
     "mcpServers": {
       "rewards-fuel": {
         "url": "https://app.rewardsfuel.com/api/mcp",
         "headers": { "Authorization": "Bearer rf_live_YOUR_KEY" }
       }
     }
   }

3. Ask for what you want in plain English.

Prompts to try

• "Create a draft giveaway called Spring Launch with newsletter sign-up, Instagram follow and refer-a-friend entry methods, and a $50 gift card prize."
• "How many entries does my Summer Giveaway have, and who are the top referrers?"
• "Export the contestants from contest 7 as CSV."
• "Draw two winners and one backup from this list and give me the proof link."

Good habits

• Give the agent a key with only the scopes it needs, and revoke keys you no longer use.
• Review a contest the agent created before you set it live. You are responsible for the official rules and prize fulfilment wherever you run it.
• The server allows 60 tool calls a minute per key. Your account scope comes from the key, so an agent can never reach another account's contests.

No agent? Use the API or webhooks

The same operations are available over the REST API, and webhooks push new entrants and winners to Make, Zapier or your own endpoint in real time. For winner selection that anyone can check, read how to pick a winner or visit the RFWIN blog.