@managebetcodes/mcp 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +58 -2
- package/dist/catalog.d.ts +31 -0
- package/dist/catalog.js +746 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +42 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +2 -0
- package/dist/server.d.ts +35 -0
- package/dist/server.js +634 -0
- package/package.json +51 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Manage Bet Codes
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,59 @@
|
|
|
1
|
-
#
|
|
1
|
+
# `@managebetcodes/mcp`
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Official Model Context Protocol (MCP) server for the [Manage Bet Codes Public API v1](https://managebetcodes.app/docs).
|
|
4
|
+
|
|
5
|
+
Zero runtime dependencies. Works with Claude Desktop, Cursor, Windsurf, Zed, OpenCode, and any MCP host over `stdio`, or connect directly to the remote Streamable HTTP endpoint at `https://api.managebetcodes.app/v1/mcp`.
|
|
6
|
+
|
|
7
|
+
## Quick Setup (`stdio`)
|
|
8
|
+
|
|
9
|
+
Create an API key (`mbc_live_...`) on the [API dashboard](https://managebetcodes.app/dashboard/api) and add this to your MCP configuration (`claude_desktop_config.json` or `.cursor/mcp.json`):
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"mcpServers": {
|
|
14
|
+
"managebetcodes": {
|
|
15
|
+
"command": "npx",
|
|
16
|
+
"args": ["-y", "@managebetcodes/mcp"],
|
|
17
|
+
"env": {
|
|
18
|
+
"MBC_API_KEY": "mbc_live_your_key"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Remote Streamable HTTP Setup
|
|
26
|
+
|
|
27
|
+
If your MCP host supports remote HTTP servers, no local package is required:
|
|
28
|
+
|
|
29
|
+
```json
|
|
30
|
+
{
|
|
31
|
+
"mcpServers": {
|
|
32
|
+
"managebetcodes": {
|
|
33
|
+
"url": "https://api.managebetcodes.app/v1/mcp",
|
|
34
|
+
"headers": {
|
|
35
|
+
"Authorization": "Bearer mbc_live_your_key"
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Included Tools (16)
|
|
43
|
+
|
|
44
|
+
- `mbc_list_bookmakers` — List all 29 bookmakers, canonical keys, aliases, and capability flags (0 credits).
|
|
45
|
+
- `mbc_list_markets` — List canonical markets and valid outcomes (0 credits).
|
|
46
|
+
- `mbc_get_usage` — Check plan, `charge_order`, API credits, regular daily credits, and rate limits (0 credits).
|
|
47
|
+
- `mbc_view_slip` — Inspect a slip's games, markets, odds, scores, and kickoff times (1 credit after success).
|
|
48
|
+
- `mbc_view_slip_image` — Render a branded PNG slip image as MCP `ImageContent` (2 credits after success).
|
|
49
|
+
- `mbc_convert_code` — Convert 1 code to 1–6 target bookmakers (2 credits per successful target).
|
|
50
|
+
- `mbc_convert_to_all` — Convert 1 code to all 27 supported target bookmakers at once (2 credits per successful target).
|
|
51
|
+
- `mbc_bulk_convert` — Bulk convert 2–4 source codes across selected or all bookmakers (2 credits per successful pair).
|
|
52
|
+
- `mbc_split_code` — Split 1 code into 2–20 codes on the same bookmaker using `equal`, `by_batches`, `target_odds`, or `custom` with `mixed` or `by_start_time` order (2 credits + 1 per extra created code).
|
|
53
|
+
- `mbc_merge_codes` — Merge 2–30 `(bookmaker, code)` pairs into 1 deduplicated code (2 credits covers one code (one already on the target bookmaker if any); each other code adds 1 if it's on the target bookmaker or 2 if it's from a different bookmaker; refunded if no code is created).
|
|
54
|
+
- `mbc_search_events` — Batch search up to 20 team/fixture queries with markets (0 credits).
|
|
55
|
+
- `mbc_get_event_markets` — List all canonical markets and live odds for an `event_id` (0 credits).
|
|
56
|
+
- `mbc_resolve_picks` — Validate 1–50 games into a 10-minute `plan_id` (0 credits).
|
|
57
|
+
- `mbc_book_code` — Mint a verified booking code on 1–6 targets from a `plan_id` or direct `picks` (2 credits per code).
|
|
58
|
+
- `mbc_manage_tracking` — Start (1 credit), inspect, list, or stop live match tracking on SportyBet, Football.com, and Betway.
|
|
59
|
+
- `mbc_manage_jobs_and_history` — Create/poll/cancel async jobs or query conversion and book history.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
export interface McpToolDefinition {
|
|
2
|
+
name: string;
|
|
3
|
+
title: string;
|
|
4
|
+
description: string;
|
|
5
|
+
inputSchema: Record<string, unknown>;
|
|
6
|
+
outputSchema: Record<string, unknown>;
|
|
7
|
+
annotations: {
|
|
8
|
+
readOnlyHint: boolean;
|
|
9
|
+
destructiveHint: boolean;
|
|
10
|
+
idempotentHint: boolean;
|
|
11
|
+
openWorldHint: boolean;
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
export interface McpResourceDefinition {
|
|
15
|
+
uri: string;
|
|
16
|
+
name: string;
|
|
17
|
+
description: string;
|
|
18
|
+
mimeType: string;
|
|
19
|
+
}
|
|
20
|
+
export interface McpPromptDefinition {
|
|
21
|
+
name: string;
|
|
22
|
+
description: string;
|
|
23
|
+
arguments: Array<{
|
|
24
|
+
name: string;
|
|
25
|
+
description: string;
|
|
26
|
+
required: boolean;
|
|
27
|
+
}>;
|
|
28
|
+
}
|
|
29
|
+
export declare const MCP_TOOLS: readonly McpToolDefinition[];
|
|
30
|
+
export declare const MCP_RESOURCES: readonly McpResourceDefinition[];
|
|
31
|
+
export declare const MCP_PROMPTS: readonly McpPromptDefinition[];
|