@managebetcodes/mcp & JSON-RPC Reference
Package
@managebetcodes/mcpRuntime
Node 18+ or Remote HTTPInstall
npx -y @managebetcodes/mcpJSON-RPC 2.0 protocol and transport reference
This page documents the JSON-RPC 2.0 wire protocol, negotiated protocol versions (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05), and tool schemas for @managebetcodes/mcp and POST https://api.managebetcodes.app/v1/mcp. Looking for interactive Claude Desktop, Cursor, Windsurf, or OpenCode setup and prompt examples? Visit the Bet Code Converter MCP Server hub.
Local stdio (claude_desktop_config.json / .cursor/mcp.json)
{
"mcpServers": {
"managebetcodes": {
"command": "npx",
"args": ["-y", "@managebetcodes/mcp"],
"env": {
"MBC_API_KEY": "mbc_live_your_key"
}
}
}
}Remote Streamable HTTP (/v1/mcp)
{
"mcpServers": {
"managebetcodes": {
"url": "https://api.managebetcodes.app/v1/mcp",
"headers": {
"Authorization": "Bearer mbc_live_your_key"
}
}
}
}Which 16 MCP tools are included
| Tool | Credits | Purpose |
|---|---|---|
mbc_list_bookmakers | 0 | List all 29 bookmakers, keys, aliases, and capability flags. |
mbc_list_markets | 0 | List canonical markets and valid outcomes. |
mbc_get_usage | 0 | Check plan, charge_order, API credits, and regular daily credits. |
mbc_view_slip | 1 (after success) | Inspect a booking code's games, markets, odds, and live scores. |
mbc_view_slip_image | 2 (after success) | Render a branded PNG slip image as MCP ImageContent. |
mbc_convert_code | 2 per target | Convert 1 code to 1–6 target bookmakers. |
mbc_convert_to_all | 2 per target | Convert 1 code to all 27 supported target bookmakers at once. |
mbc_bulk_convert | 2 per pair | Bulk convert 2–4 source codes across selected or all bookmakers. |
mbc_split_code | 2 + 1 per extra part | Split 1 code into 2–20 codes using equal, by_batches, target_odds, or custom. |
mbc_merge_codes | 2 + 1 per extra code | Combine 2–30 (bookmaker, code) pairs into 1 deduplicated code. |
mbc_search_events | 0 (search cap) | Search up to 20 team or fixture queries with top markets. |
mbc_get_event_markets | 0 (search cap) | Fetch all canonical markets and live odds for an event_id. |
mbc_resolve_picks | 0 (search cap) | Resolve 1–50 games into a 10-minute plan_id. |
mbc_book_code | 2 per code | Mint a verified booking code from a plan_id or direct picks. |
mbc_manage_tracking | 1 on start | Start, inspect, list, or stop live match tracking. |
mbc_manage_jobs_and_history | Job price on create | Create/poll/cancel async jobs or query conversion and book history. |