Robo Punter

Connect Claude, ChatGPT or Grok to Robo Punter: research horse and greyhound form, backtest ideas across thousands of past races and draft bots for your Betfair account.

Hosted MCP Server

npx add-mcp 'https://robopunter.io/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Your AI reads live markets, form and results, researches and backtests strategies, and manages your bots: 47 tools on your own account. Betting and bot control only happen with your permission.

Works withClaudeChatGPT Grokand other AI apps that support connectors

Server URL

Paste it into your AI app’s connector settings

https://robopunter.io/mcp

Agent Access uses MCP (Model Context Protocol), the open standard AI apps use for connectors.

What you need

  • Pro plan Agent Access is included, within its daily limits. View plans
  • Betfair connected Your AI works while your Betfair account is connected to Robo Punter. Connect Betfair
  • Your AI app Claude, ChatGPT (developer mode), Grok or another AI app that supports connectors.

Connect your AI

Choose your app and follow its steps. Setup takes about a minute.

  1. In Claude, open Customize → Connectors.
  2. Choose + → Add custom connector. Name it Robo Punter and paste the server URL.
  3. Choose Connect, sign in to Robo Punter and approve access.
  4. Turn on Robo Punter from the connectors menu in your chat.

Team or Enterprise workspaces: an owner adds the connector first. It then works in Claude's mobile app too. Official Claude guide

  1. On the web, open Settings → Security and login and turn on Developer mode.
  2. Open Plugins and choose + to add an app. Name it Robo Punter and enter the server URL.
  3. Choose Streamable HTTP and OAuth if asked (and dynamic client registration if offered), then sign in to Robo Punter and approve access.
  4. In a new chat, open + → Developer mode and select Robo Punter.

Needs an eligible ChatGPT plan with custom apps allowed. Menu names can vary by version. Official ChatGPT guide

  1. Send your Bot the message below.
  2. Sign in to Robo Punter and approve access. To let it bet in Paper mode, tick Place individual Paper bets.
  3. Ask it the check question below.
Connect to the Robo Punter MCP server at https://robopunter.io/mcp

Every Bot that uses this connection shares its permissions.

  1. Run the command below in your terminal.
  2. In Claude Code, run /mcp and select Robo Punter to sign in.
  3. Approve access in your browser, then return to Claude Code.
claude mcp add --transport http robopunter https://robopunter.io/mcp

Official Claude Code guide

  1. Run these commands to add the server and start sign-in.
  2. Sign in to Robo Punter in your browser and approve access.
  3. Start a new Codex task and ask it to use Robo Punter.
codex mcp add robopunter --url https://robopunter.io/mcp
codex mcp login robopunter

In the Codex app's MCP settings, add the same URL as a Streamable HTTP server and choose Authenticate. Official Codex guide

  1. Open ~/.cursor/mcp.json (create it if it doesn't exist).
  2. Add the robopunter entry below inside mcpServers.
  3. Save, restart Cursor and complete the Robo Punter sign-in when asked.
{
  "mcpServers": {
    "robopunter": {
      "url": "https://robopunter.io/mcp"
    }
  }
}

Official Cursor guide

  1. Add a remote MCP server with the server URL.
  2. Choose Streamable HTTP and OAuth sign-in.
  3. Sign in to your Pro Robo Punter account and approve access.

App only takes a header? Create a personal token in Agent Access and send Authorization: Bearer YOUR_TOKEN. Keep it private. Personal tokens

Check it works

“Use Robo Punter to check my account capabilities and list my bots. Do not change anything.”

Guide: build an AI betting desk with Grok Bot

What your AI can see and do

Ask in plain words. Your AI picks the tools it needs, within the permissions you give it.

  • Live market

    • Live Betfair prices, market state and projected SP
      • Each runner’s name, box or saddlecloth and barrier, last traded price, matched volume and volume share
      • 5 and 10-minute price moves and market profile, as on the race page
      • Place markets, and a watch on up to 20 races for price, scratching, going and start-time changes
  • Race & form

    • Full race details: track, distance, going, class, prize money and every published form stat for each runner
      • Field form with race shape, Smart Form picks and when the form was published
      • Horse gear and venue tier; greyhound early-speed flags
      • Races ranked by form-score gap, course-and-distance records and a readiness check
  • Results

    • Any day’s finished races, alongside upcoming ones
      • Finishing positions and margins where recorded
      • Betfair win and place results with BSPs
  • Research

    • Split any record by up to 3 form factors, such as going, class, distance or weight, into up to 50 groups
      • Horse, greyhound, jockey and trainer profiles: up to 50 past runs per runner, upcoming entries, jockey rides and trainer stables
      • Rankings, Strategy scans for bot ideas, backtests, walk-forward and forward tests
  • Your bots & account

    • Your bots, ratings, results, recent bets and portfolio, in Real money or Paper
      • Draft, edit, pause and archive bots; new drafts always start paused
      • Your Betfair balance, exposure and open positions, read-only (you can switch this off in Settings)
      • Your follows and today’s runners for them, and what’s left of today’s allowance
  • Live operations

    Your permission
    • Back and lay bets on your Betfair account within your limits; check, amend or cancel unmatched bets
      • Paper bets while your account is in Paper mode
      • Turn your bots on and off

Try asking

  • “Use Robo Punter to show the next race at [track] with live prices and the biggest movers.” Copy
  • “Find [horse] on Robo Punter and split its record by going and distance over the last year.” Copy
  • “Show me today's finished races at [track] with the results and BSPs.” Copy
  • “Use a Strategy scan to find an AU horse lay idea, backtest it, and draft it as a paused bot if it holds up.” Copy

You stay in control

  • Drafts wait for you Every bot your AI creates starts paused. Switch it on yourself, or let an agent you’ve permitted do it.
  • Every call is logged Each request is recorded against your account. The latest show in Settings → Agent Access.
  • Your account only Apps sign in as you and work on your account alone. Disconnect an app or revoke a token at any time.

Betting and bot control

  • Real-money bets and bot control are off until you switch them on in Settings → Agent Access. Each app or token also needs its own grant.
  • You set a maximum loss per bet and a daily risk allowance, shared by every app. Your bots keep their own staking.
  • You and your agents choose when to bet, including in-play if you allow it. Live market reads show bot timing for reference only.
  • Paper mode blocks real-money bets, and agents never switch your account's mode.
  • The same bet sent by several agents is only placed once. Give betting permission to one agent that places the bets.
  • Stop or disconnect at any time. Running bots and existing orders stay as they are. Set permissions

Your live 4 and 5-star bots can’t be copied through Agent Access

No one else’s AI can discover, backtest or save an exact copy of a custom bot with a current 4 or 5-star rating while it’s live, or for 14 days after you pause it. Turn it back on and it’s covered again. Archived bots and drafts aren’t covered.

Up to 250 bots per account are covered: live bots first, then the most recently paused.

Single filters stay open to everyone, and changing only a bot’s name, stake or bank doesn’t make it a new strategy. Protection follows the bot’s current rating in My Bots; a full-history backtest of the saved bot through Agent Access updates it.

It doesn’t guarantee exclusive bets or market liquidity.

Daily limits

Pro includes Agent Access with Strategy scans, where your AI searches past races for filter combinations that made a profit. Everything resets at 6 AM Sydney time.

AllowancePro
Backtests a day Test a bot’s rules on past races. Shared with the website.Unlimited
Strategy scans a day Your AI searches past races for filter combinations that made a profit. Each is a lead to confirm with a backtest.12
Research lookups Each search, profile, ranking or form split your AI runs each day, across all your apps.1,500
Research results Each runner, run or group in an answer counts as one, each day.75,000
Past runs per runner How many of a horse’s or greyhound’s past runs your AI reads at once.50
Groups per form split Your AI splits a record by going, distance, class or any other factor into this many groups.50
Bot drafts a day New bots your AI saves for you, each starting paused until you switch it on.20

Up to 60 requests a minute and 10 at once. Everything resets at 6 AM Sydney time. Ask your AI “How much of my Robo Punter allowance is left?”

All 47 tools

Your AI receives each tool’s full details when it connects. Read tools change nothing; write tools act on your own bots and bets.

47 of 47 tools

Start here · 5

get_account_capabilities

Read-only

Start here: your plan, Betfair connection, supported markets, what is left of today's allowances, and whether your account bets with Real money or on Paper (with your paper wallet's balance).

No parameters.

get_agent_permissions

Read-only

New

Read your current agent betting and bot-control permissions, manual risk limits, expiry and connection grants.

No parameters.

list_follows

Read-only

Read a page of your website follows, and optionally today's runners for them.

Optional entity_type, limit (1–100), offset (0–10,000), runners_today.

follow_entity

Write

Follow a horse, greyhound, jockey or trainer on your website account.

entity_type, entity_id.

unfollow_entity

Write

Remove one of your website follows.

entity_type, entity_id.

Live market · 2

get_live_market

Read-only

New

Read fresh Betfair prices, market state, race status and freshness, with each runner's name, box or saddlecloth and barrier, live and recorded last traded price, matched volume and volume share, recorded price about 5 and 10 minutes ago, Betfair projected SP, and 5 and 10-minute price moves with the market profile as on the race page (greyhounds: 5 minutes). Also lists the race's place markets. Existing bot timing is shown for reference only; you decide when agents bet, including in-play.

Required: market_id, sport (horse or greyhound). Optional: include_movement (default true; false for a faster read). A place market_id reads that market's recorded prices.

watch_races

Read-only

New

Watch status, prices, scratchings, going and start-time changes across multiple races. The client continues bounded polling; users choose timing.

Required: markets (1–20 market_id/sport pairs). Optional: cursor, wait_seconds (0–15), events.

Races, form & results · 6

discover_upcoming_races

Read-only

Find today's or upcoming horse and greyhound races, or one day's finished races, in each meeting's own timezone.

Optional sport, country, meeting_id, date, days_ahead (1–7), status (upcoming [default], finished, all), limit (1–200).

get_race_details

Read-only

New

Read track, start time, distance, going, class, prize money, all runners and every published form/statistics field, including Last5/10/15 and sport-specific metrics. Works before, during and after a race; finished races add results (finishing positions where stored, margins, Betfair win and place results and BSPs). Horses also show venue tier and the race card's gear text. Missing values and timestamps are explicit.

Required: market_id. Optional: sport, form_fields (select specific published stats; omit for all). Live prices: get_live_market. Histories and further splits: get_runner_form_history, get_entity_profile and research_form_factors.

get_race_field_form

Read-only

Read every active runner's published form, scratchings and how complete the field is, with the race shape for each form period, the race's Smart Form picks, when the form was published and, for greyhounds, which runners lack early speed.

market_id; optional sport, max_age_minutes.

rank_race_standouts

Read-only

Rank upcoming races by the form-score gap between the top runner and the next, with each race's shape, ties shown and when each field's form was published.

market_ids (1–100); optional sport, form_period (last_5, last_10 [default], last_15), max_age_minutes, limit.

research_course_distance

Read-only

Read each upcoming horse's record at this exact course over its scheduled distance.

market_ids (1–50); optional distance_band_m (0–200, default exact distance).

get_race_readiness

Read-only

New

Summarise stored form coverage, missing race facts, age and live field/status freshness. Advisory only; no source certification or timing gate.

Required: market_id. Optional: sport, max_form_age_minutes (1–10080, default 120).

Research & backtests · 13

list_form_factors

Read-only

New

List the bot-builder form factors you can research, and the stored per-run details behind them.

Optional: sport, limit (1–100), offset (0–1,000).

research_form_factors

Read-only

New

Split recorded performance by up to three bot-builder factors for a runner, a current race field, a jockey, trainer, sire or venue. Splits report starts, wins and win rate. Place rate and average finish appear only where finishing positions are recorded.

scope (runner, race_field or entity), group_by; identity or market_id; optional sport, country, dates (up to 366 days), form_period, bet_type, market_type, bucket_width, min_samples, place_n, max_groups (1–50).

get_runner_form_history

Read-only

New

Read a horse's or greyhound's stored runs one by one: result, one stored SP per run and the per-run details recorded, such as going, class, weight, barrier or box, connections and sectionals.

entity_type (horse or greyhound), entity_id; optional from_date, to_date, limit (1–50).

search_entities

Read-only

Search horses, greyhounds, jockeys and horse or dog trainers for their canonical ids.

entity_type, query; optional country, limit (1–50).

get_entity_profile

Read-only

Read one profile with its stored form and the history it covers. Horses and greyhounds include their next five races, jockeys their recent rides and horse trainers a page of their stable.

entity_type, entity_id (jockeys and trainers also by name); optional country, history_limit (1–500), since_date (jockeys), horses_offset (trainers).

rank_entities

Read-only

Rank horses, jockeys and trainers by a recorded metric, with the sample behind each rank.

entity_type, metric; optional country, condition, period, min_starts, direction, limit (1–100), offset (0–10,000).

get_supported_filters

Read-only

Find the available filters and operators before building a strategy.

Required: sport (horse or greyhound).

scan_candidates

Research

Strategy scans (12 a day): search past races for filter combinations that made a profit, back or lay. Each result is a lead to confirm with run_backtest.

Required: country, bet_type. Optional settings include sport, scope, date range and max_results (up to 25).

run_backtest

Research

Test a strategy, or one of your saved bots exactly as saved, against recorded races with the canonical backtest engine, and review its results, risk and data notes. Returns a job reference; check get_backtest_status until it completes to see results. Uses one daily backtest allowance, shared with the website. Add walk_forward for a Walk-forward test: one backtest that builds on the first 80% of your period and tests on the latest 20% (at least 30 days). Its test results stay hidden until you commit it as final with commit_walk_forward.

Either country, bet_type and filters (optional: sport, market_type, form_period, date range and staking), or bot_id to run one of your bots as saved (optional: date range). Optional: walk_forward (true or false; needs bot_id or one staking plan).

get_backtest_status

Research

Check progress or retrieve a completed backtest, with its rating and six checks. A Walk-forward test shows only the period it was built on until you commit it; a Forward test read shows how the locked bot has done since the lock. Status checks do not use another backtest allowance.

Required: job_id returned by run_backtest.

commit_walk_forward

Research

Commit the strategy in a Walk-forward test as final and see how it did on the latest races it never saw, with a plain verdict (marked as an early read when the test has few bets). A commit is permanent, and later Walk-forward tests of the same strategy over the same days show how many times they were already checked. Uses no backtest allowance.

Required: job_id of a completed Walk-forward test.

forward_test

Research

Forward test: lock one of your saved bots and judge it only on races run after the lock. It starts the next day, runs for 7 to 90 days (30 by default) and can never be edited. List your forward tests for free; each read replays the locked bot over the races since the lock, uses one daily backtest and is checked with get_backtest_status.

Required: action (start, list or read). start: bot_id, optional days (7–90). list: optional bot_id. read: forward_test_id.

compare_backtests

Research

Compare two backtests on the same dates: headline results side by side with the differences, the bets both backed and the bets only one backed, and each side's profit on each. Each side that has to run uses one daily backtest allowance; a side you already ran through Agent Access with the same settings in the last 7 days is reused free, as long as no racing data has been corrected since. Every call, including progress checks, is one research call. Walk-forward tests can't be compared.

Two of your bots (bot_id_a, bot_id_b), or one bot and a strategy (bot_id_a, config_b with one staking plan); then job_ids to check progress. Optional: sample_size (0–10).

Your bots · 10

list_bots

Read-only

List your bots, their current status and their five-star rating.

Optional: include_archived (boolean), min_rating (1–5 stars).

get_bot

Read-only

Read a bot's filters, staking, last backtest headline (with its balance curve) and rating with its six checks, consistency score and full assessment, plus its all-time results. Read-only bots return a summary, their rating and their results.

Required: bot_id (string).

get_bot_performance

Read-only

Review settled results, net profit, strike rate, closing line value, profit factor, drawdown, streaks, money in open bets and recent bets for a bot, from Real money or Paper bets. Paper results never change a bot's rating.

Required: bot_id (string). Optional: days (number), book (live for Real money or paper; defaults to your account's current mode).

get_portfolio_summary

Read-only

Compare your bots' ratings, results and overall portfolio performance, with Real money or Paper bets.

Optional: days (1–90, defaults to 30), book (live for Real money or paper; defaults to your account's current mode).

create_bot_draft

Write

Save a new bot after testing its rules. It always starts paused.

Required: name, country, bet_type, filters, staking_plan. Optional settings include sport, market_type, description and staking_config.

update_bot

Write

Edit a paused custom bot's name, filters or staking. Pause a live bot first.

Required: bot_id, plus the fields to change. Sport, country, market, bet type and activation stay as they are.

pause_bot

Write

Pause one of your custom bots.

Required: bot_id (string).

archive_bot

Write

Archive a custom bot. Its bet history is kept, and you can restore it on the website.

Required: bot_id (string).

activate_bot

Write

New

Activate one of your saved bots using its saved staking and the current account mode. Needs explicit bot-control permission and on-site consent.

Required: bot_id, expected_updated_at (from the current bot), betting_mode (real_money or paper), confirm:true.

disable_bot

Write

New

Pause and disable one of your bots, including status-only control of bots whose settings are private. Existing bets remain.

Required: bot_id; bot-control grant.

Bets & funds · 11

list_recent_bets

Read-only

Read your newest bets, including bot and manual bets. Paper bets are marked as paper.

Optional: bot_id, status, sport (horse or greyhound), limit (1–200), book (live for Real money or paper; defaults to your account's current mode).

get_account_funds

Read-only

New

Read your own Betfair balance, exposure and wallet currency. Read-only; on for every connection unless you switch balance reading off in Settings → Agent Access.

No parameters.

get_open_positions

Read-only

New

Read all current own Betfair orders, account exposure and per-market/runner risk estimates, including bots and external manual bets. Read-only; on for every connection unless you switch balance reading off in Settings → Agent Access.

No parameters. WIN and PLACE risk remain separate.

preview_manual_bet

Read-only

New

Preview a proposed order, maximum loss, displayed liquidity, funds and permissions without placing or reserving anything.

Required: market_id, sport, selection_id, side, order_type (limit, market or bsp), in_play, and one of stake, liability or stake_percent (0.5, 1, 2, 5 or 10% of balance), as in place_manual_bet; price for LIMIT. Optional: book (live or paper). Shows the resolved stake, price and maximum loss.

place_manual_bet

Write

New

Place an individual real BACK/LAY order with the bet slip's options (limit, market or BSP; stake, liability or a percentage of your balance), explicit permission and shared account limits. Retries reuse the same request key; unknown outcomes are reconciled.

Required: market_id, sport, selection_id, side, order_type (limit, market or bsp), real_money:true, in_play, request_key, valid_until (within 120 seconds), and one of: stake (BACK stake, or a LAY limit/market backer's stake), liability (LAY limit or BSP maximum loss) or stake_percent (0.5, 1, 2, 5 or 10% of available balance). LIMIT: price; MARKET takes no price. Optional: cancel_at (unmatched cancellation deadline within 24 hours), persistence_type, agent_name, repeat_of_request_id (intentional repeat of a confirmed identical order). Timing is set by you and your agents.

get_manual_bet

Read-only

New

Confirm one of your agent manual orders against current and cleared Betfair orders.

Required: request_id or request_key.

amend_manual_bet

Write

New

Reduce unmatched size, change price through cancel-then-place, or set/remove an unmatched cancellation deadline. Matched bets remain.

Required: request_id, stable request_key, action (price/reduce/deadline). Price: price, in_play. Reduce: size_reduction (backer stake). Deadline: cancel_at within 24h, or null. Unknown commands are not retried.

cancel_manual_bet

Write

New

Cancel the unmatched portion of your agent manual order. Matched bets remain.

Required: request_id or request_key; betting grant.

place_paper_bet

Write

New

Place an individual simulated bet using the existing Paper wallet and fill model. Account must already be in Paper mode. On for every connection unless you switch off Place paper-money bets in Settings → Agent Access.

Same order fields as preview; paper:true, request_key and valid_until required. In-play LIMIT remainders lapse immediately; no PERSIST.

get_paper_bet

Read-only

New

Read your MCP Paper request and current simulated fill or settlement receipt.

Required: request_id or request_key.

cancel_paper_bet

Write

New

Cancel only the unmatched remainder of your own MCP Paper LIMIT before the start, preserving evidenced fills.

Required: request_id or request_key. Works even after you switch Paper bets off.

Trouble connecting?

My AI says “Connect your Betfair account at robopunter.io to use Agent Access.”

Agent Access works while your Betfair account is connected, and Robo Punter renews the session as your AI works. Reconnect in Settings → Betfair, then ask again. Your apps and tokens are kept. If your app asks you to sign in again, reconnect Robo Punter there.

Sign-in works, but the tools don't appear

Check that your plan is Pro and Betfair is connected. Then turn on Robo Punter in the chat and start a new chat or task.

I can't find the custom connector option

Check your AI app's plan and workspace permissions; an administrator may need to allow custom connectors. The official guide is linked under your app's steps.

I opened the server URL and saw an error

That's expected: the URL is for your AI app, not your browser. Paste it into the app's connector settings.

A request was refused or a limit was reached

Backtests, Strategy scans, drafts and research all reset at 6 AM Sydney time. Ask your AI “How much of my Robo Punter allowance is left?”

I want to remove access

Open Settings → Agent Access and disconnect the app or revoke its token. Its next request is refused.

Still stuck? Contact support