Bet Code Converter MCP Server for Claude, Cursor & AI Agents

The Manage Bet Codes MCP Server (@managebetcodes/mcp and POST https://api.managebetcodes.app/v1/mcp) connects Claude Desktop, Cursor, Windsurf, and OpenCode to 29 Nigerian and international bookmakers including SportyBet, Bet9ja, 1xBet, and MSport. It exposes 16 tools, 4 resources, and 4 workflow prompts so AI assistants can convert, split, merge, view, track, and book betting codes from plain English.

Get Free API Key (5 test credits)JSON-RPC Protocol Reference →Web bet code converter →

Prefill API key (optional):

Config file: claude_desktop_config.json

{
  "mcpServers": {
    "managebetcodes": {
      "command": "npx",
      "args": ["-y", "@managebetcodes/mcp"],
      "env": {
        "MBC_API_KEY": "mbc_live_your_api_key"
      }
    }
  }
}

Verified Free accounts include 5 lifetime action credits and 500 free searches/day to test MCP tools immediately.Create mbc_live_ API key →

Interactive prompt → MCP tool simulator

Prompt: convert-to-all-bookmakersTool chain: mbc_convert_to_all · 2 credits per successful target bookmaker

“Convert SportyBet booking code 7B9A2F to all supported bookmakers and show which games converted.”

MCP tools/call Request

{
  "name": "mbc_convert_to_all",
  "arguments": {
    "code": "7B9A2F",
    "from_bookmaker": "sportybet",
    "include_card": false
  }
}

Structured Tool Result

{
  "success": true,
  "tool": "convert_to_all",
  "pairs": 26,
  "successful_pairs": 25,
  "credits_charged": 50,
  "slips": [
    {
      "source": {"key": "sportybet", "name": "SportyBet", "code": "7B9A2F"},
      "results": [
        {"target": {"key": "onexbet", "name": "1xBet"}, "success": true, "target_code": "R9QF0U", "converted_count": 8, "original_count": 8},
        {"target": {"key": "bet9ja", "name": "Bet9ja"}, "success": true, "target_code": "B9JA881", "converted_count": 8, "original_count": 8},
        {"target": {"key": "msport", "name": "MSport"}, "success": true, "target_code": "B294011", "converted_count": 8, "original_count": 8}
      ]
    }
  ]
}

How do I connect Manage Bet Codes to Claude Desktop, Cursor, or OpenCode?

Connect any Model Context Protocol host to Manage Bet Codes in two ways: run the zero-dependency local stdio package with npx -y @managebetcodes/mcp using Node.js 18+, or connect directly to the stateless remote Streamable HTTP endpoint at https://api.managebetcodes.app/v1/mcp with an Authorization: Bearer mbc_live_... or X-API-Key header. Both transports expose the same 16 tools.

Local stdio package compared with the remote Streamable HTTP endpoint
Transport Mode	Endpoint / Command	Authentication	Best For
Remote Streamable HTTP	`POST https://api.managebetcodes.app/v1/mcp`	`Authorization: Bearer mbc_live_...` or `X-API-Key: mbc_live_...`	Zero local install; hosted agents, OpenCode, Cursor remote MCP, and cloud workflows.
Local stdio Package	`npx -y @managebetcodes/mcp`	`MBC_API_KEY=mbc_live_...` environment variable	Claude Desktop, local IDE assistants, and environments that launch MCP servers over standard input/output.

What can AI agents do with the 16 Manage Bet Codes MCP tools?

The Manage Bet Codes MCP Server exposes 16 tools across five workflows: free bookmaker and market catalog discovery (0 credits), structured JSON and PNG slip viewing (1–2 credits), single, all-bookmaker, and bulk code conversion (2 credits per target), splitting into 2–20 codes or merging 2–30 codes, and natural-language slip booking and live tracking.

The 16 Manage Bet Codes MCP tools with their workflow, credit price, and behaviour
Tool Name	Workflow	Credit Price	Behavior	What It Does
`mbc_list_bookmakers`	Discovery	0 credits	Read-only · Idempotent	List all 29 supported bookmakers, canonical keys, aliases, and conversion, booking, search, and tracking capability flags.
`mbc_list_markets`	Discovery	0 credits	Read-only · Idempotent	List all canonical betting markets (1X2, Over/Under, BTTS, Double Chance, Handicap) and their valid outcome keys.
`mbc_get_usage`	Account	0 credits	Read-only · Idempotent	Read the active plan, key charge_order, API credit balance, regular daily credit balance, and rate limits.
`mbc_view_slip`	View Slip	1 credit (after success)	Read-only · Idempotent	Inspect any booking code and return structured JSON with games, teams, markets, odds, and live match scores.
`mbc_view_slip_image`	View Slip	2 credits (after success)	Read-only · Idempotent	Render a branded PNG slip image and return native MCP ImageContent plus structured metadata.
`mbc_convert_code`	Conversion	2 credits / target	Code-minting	Convert one booking code from a source bookmaker into 1 to 6 target bookmakers in a single call.
`mbc_convert_to_all`	Conversion	2 credits / target	Code-minting	Fan out one booking code across all eligible target bookmakers at once using per-family concurrency lanes.
`mbc_bulk_convert`	Conversion	2 credits / pair	Code-minting	Bulk convert 2 to 4 source booking codes across selected or all bookmakers, automatically skipping each slip's own source.
`mbc_split_code`	Split & Merge	2 + 1 / extra part	Code-minting	Divide one booking code into 2 to 20 smaller codes using equal, by_batches, target_odds, or custom game counts.
`mbc_merge_codes`	Split & Merge	2 + 1 / extra code	Code-minting	Combine 2 to 30 (bookmaker, code) pairs into one deduplicated booking code on the chosen target bookmaker.
`mbc_search_events`	Natural-Language Booking	0 credits (search cap)	Read-only · Idempotent	Search up to 20 team or fixture queries in one call and return event_ids, kickoff times, and top markets.
`mbc_get_event_markets`	Natural-Language Booking	0 credits (search cap)	Read-only · Idempotent	Fetch the full canonical market and live odds catalog for a specific event_id.
`mbc_resolve_picks`	Natural-Language Booking	0 credits (search cap)	Read-only · Idempotent	Resolve 1 to 50 natural-language games into native bookmaker IDs and issue a 10-minute plan_id.
`mbc_book_code`	Natural-Language Booking	2 credits / code	Code-minting	Mint a verified native booking code on a target bookmaker from a resolved plan_id or direct picks.
`mbc_manage_tracking`	Live Tracking	1 credit on start	State-changing	Start, inspect, list, or stop live match tracking on SportyBet, Football.com, and Betway with optional HTTPS webhooks.
`mbc_manage_jobs_and_history`	Async Jobs & History	0 to read · job price on create	Mixed	Create, poll, or cancel async batch jobs (up to 100 code-target pairs) and query conversion or booking history.

4 Read-Only MCP Resources (0 credits)

mbc://catalog/bookmakers

Supported Bookmakers Catalog

Live JSON registry of all 29 bookmakers, aliases, code regex hints, and capability flags.

mbc://catalog/markets

Canonical Betting Markets Catalog

Complete list of canonical market names, line rules, and outcome identifiers.

mbc://catalog/capabilities

API v1 Capabilities Manifest

Machine-readable manifest of every Public API v1 route, credit price, and rate limit.

mbc://account/usage

Current Key Quota & Credit Balance

Real-time snapshot of API plan credits, regular daily credits, and remaining search quota.

How do AI agents build, split, and convert betting slips from plain English?

AI agents use four built-in MCP prompts (convert-to-all-bookmakers, bulk-convert-codes, split-slip, and build-slip-from-text) to chain multi-step workflows automatically. To build a slip from text, the agent searches fixtures (mbc_search_events) and validates markets (mbc_resolve_picks) for 0 credits before spending 2 credits on mbc_book_code to mint a verified booking code.

/convert-to-all-bookmakers

Args: code, from_bookmaker, targets?

Converts one booking code to every supported bookmaker and formats a comparison table of converted games and odds.

/bulk-convert-codes

Args: codes_list, targets?

Parses 2 to 4 booking codes from plain text and runs a single bulk fan-out conversion across target bookmakers.

/split-slip

Args: code, bookmaker, method?, order?, value?

Splits a long accumulator into 2 to 20 balanced codes using equal, by_batches, target_odds, or custom game counts.

/build-slip-from-text

Args: bookmaker, picks_text

Chains 0-credit fixture search and pick resolution before minting a verified booking code with mbc_book_code.

Which bookmakers are supported by the Manage Bet Codes MCP server?

The Manage Bet Codes MCP Server supports 29 bookmakers as conversion and view sources, 27 bookmakers as conversion and booking targets, and 3 bookmakers (SportyBet, Football.com, and Betway) for live match tracking. Supported platforms include SportyBet, Bet9ja, 1xBet, MSport, BetKing, 22Bet, Paripesa, Melbet, Megapari, 888starz, Betwinner, Helabet, and Afropari.

Convert Bet Codes →

Single-code converter across SportyBet, Bet9ja, 1xBet, MSport, and 25 more bookmakers.

Convert to All Bookmakers →

Fan out one booking code to every eligible bookmaker with a 1080×1920 share card.

Split Bet Codes (2–20 parts) →

Divide accumulators using Equal, By batches, Target odds, or Custom game counts.

All 29 Supported Bookmakers →

Full capability matrix for conversion, live match tracking, and slip rendering.

How much does the Manage Bet Codes MCP server cost to use?

The @managebetcodes/mcp package and POST /v1/mcp endpoint are free to connect, and every verified Free account includes 5 lifetime action credits (1 API key, 10 requests/minute, and 500 searches/day while testing). Any regular plan works for MCP and API calls — Starter (₦999/month, 28 daily credits), Pro, or Tipster — and dedicated API plans start at ₦4,999/month on Developer (5,000 monthly API credits, as of November 2026). Failed conversions cost 0 credits.

MCP and API plan pricing, included credits, and daily search limits
Plan / Tier	Price (NGN)	Included Credits	Rate Limit	Daily Searches & Resolves
Free (Verified Email)	₦0	5 lifetime action credits	10 req / min	500 / day while testing
Starter (Regular Plan)	₦999 / month	28 daily action credits	20 req / min	1,000 / day
Pro (Regular Plan)	₦2,499 / month	93 daily action credits	30 req / min	5,000 / day
Tipster (Regular Plan)	₦4,999 / month	190 daily action credits	60 req / min	10,000 / day
Developer (API Plan)	₦4,999 / month	5,000 monthly API credits	60 req / min	20,000 / day
Scale (API Plan)	₦9,999 / month	12,000 monthly API credits	120 req / min	50,000 / day
Business (API Plan)	₦19,999 / month	30,000 monthly API credits	300 req / min	100,000 / day

Frequently Asked Questions about the Manage Bet Codes MCP Server

Does the Manage Bet Codes MCP server place real-money bets?

No. Manage Bet Codes never touches bookmaker accounts, wallets, or wagers. Every MCP tool reads, converts, splits, merges, tracks, or mints shareable booking codes that users can paste into their own bookmaker app.

Should I use the local stdio package (@managebetcodes/mcp) or the remote HTTP endpoint (/v1/mcp)?

Both expose the exact same 16 tools, 4 resources, and 4 prompts. Use the remote Streamable HTTP endpoint (https://api.managebetcodes.app/v1/mcp) when your MCP client supports remote URLs with headers and you want zero local setup. Use npx -y @managebetcodes/mcp for desktop clients configured via local stdio.

What happens if a game or market is unavailable on the target bookmaker?

Every conversion result reports original_count, converted_count, and a per-game breakdown of skipped games with the exact reason (such as a market not offered or a match already in play). Nothing is silently altered.

Can Claude Desktop or Cursor display the rendered slip PNG image?

Yes. Calling mbc_view_slip_image returns a native MCP ImageContent block (mimeType: image/png, base64-encoded) alongside structured JSON metadata, so MCP hosts that render images display the slip card directly in chat.

How are credits charged when using MCP tools?

Discovery and fixture preparation tools (mbc_list_bookmakers, mbc_list_markets, mbc_get_usage, mbc_search_events, mbc_get_event_markets, mbc_resolve_picks) cost 0 credits. Viewing a slip costs 1 credit (or 2 credits for a PNG), converting or booking costs 2 credits per successful target code, and splitting or merging costs 2 credits plus 1 per additional part. Failed conversions and unused split parts are refunded automatically.

Which Model Context Protocol versions are supported?

Both @managebetcodes/mcp and POST /v1/mcp negotiate MCP protocol versions 2025-11-25, 2025-06-18, 2025-03-26, and 2024-11-05 over JSON-RPC 2.0.