@baozi.bet/mcp-server 4.0.0 → 4.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/README.md +36 -90
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -1,34 +1,23 @@
|
|
|
1
|
-
# @baozi/mcp-server
|
|
1
|
+
# @baozi.bet/mcp-server
|
|
2
2
|
|
|
3
3
|
**MCP (Model Context Protocol) server for Baozi prediction markets on Solana**
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/@baozi/mcp-server)
|
|
5
|
+
[](https://www.npmjs.com/package/@baozi.bet/mcp-server)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
7
|
|
|
8
|
-
##
|
|
9
|
-
|
|
10
|
-
This MCP server enables AI agents to interact with [Baozi](https://baozi.bet) prediction markets on Solana. It provides **66 tools** for:
|
|
11
|
-
|
|
12
|
-
- **Market Discovery** - List and filter boolean/race markets
|
|
13
|
-
- **Quote Calculation** - Expected payouts with odds analysis
|
|
14
|
-
- **Transaction Building** - Unsigned transactions for betting, claims, resolution
|
|
15
|
-
- **Position Management** - View wallet positions and claimable winnings
|
|
16
|
-
- **Validation** - Enforce v6.2 timing rules before market creation
|
|
8
|
+
## Quick Install
|
|
17
9
|
|
|
18
|
-
|
|
10
|
+
```bash
|
|
11
|
+
# Install globally
|
|
12
|
+
npm install -g @baozi.bet/mcp-server
|
|
19
13
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
│
|
|
23
|
-
▼
|
|
24
|
-
User Wallet ──► Signs ──► Solana Network
|
|
14
|
+
# Or run directly
|
|
15
|
+
npx @baozi.bet/mcp-server
|
|
25
16
|
```
|
|
26
17
|
|
|
27
|
-
##
|
|
18
|
+
## Claude Desktop Setup
|
|
28
19
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
Add to your Claude Desktop config:
|
|
20
|
+
Add to your config file:
|
|
32
21
|
|
|
33
22
|
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
34
23
|
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
@@ -38,18 +27,29 @@ Add to your Claude Desktop config:
|
|
|
38
27
|
"mcpServers": {
|
|
39
28
|
"baozi": {
|
|
40
29
|
"command": "npx",
|
|
41
|
-
"args": ["@baozi/mcp-server"]
|
|
30
|
+
"args": ["@baozi.bet/mcp-server"]
|
|
42
31
|
}
|
|
43
32
|
}
|
|
44
33
|
}
|
|
45
34
|
```
|
|
46
35
|
|
|
47
|
-
|
|
36
|
+
## Overview
|
|
48
37
|
|
|
49
|
-
|
|
38
|
+
This MCP server enables AI agents to interact with [Baozi](https://baozi.ooo) prediction markets on Solana. It provides **66 tools** for:
|
|
50
39
|
|
|
51
|
-
|
|
52
|
-
|
|
40
|
+
- **Market Discovery** - List and filter boolean/race markets
|
|
41
|
+
- **Quote Calculation** - Expected payouts with odds analysis
|
|
42
|
+
- **Transaction Building** - Unsigned transactions for betting, claims, resolution
|
|
43
|
+
- **Position Management** - View wallet positions and claimable winnings
|
|
44
|
+
- **Validation** - Enforce v6.2 timing rules before market creation
|
|
45
|
+
|
|
46
|
+
**Key Principle**: Agent builds, User signs. No private keys in agent.
|
|
47
|
+
|
|
48
|
+
```
|
|
49
|
+
AI Agent ──► MCP Tool ──► Unsigned Transaction (base64)
|
|
50
|
+
│
|
|
51
|
+
▼
|
|
52
|
+
User Wallet ──► Signs ──► Solana Network
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
## Tool Categories (66 Tools)
|
|
@@ -158,14 +158,10 @@ npx @baozi/mcp-server
|
|
|
158
158
|
| `validate_market_params` | Validate against v6.2 rules |
|
|
159
159
|
| `validate_bet` | Validate bet parameters |
|
|
160
160
|
|
|
161
|
-
###
|
|
161
|
+
### Resolution Status (4 tools)
|
|
162
162
|
| Tool | Description |
|
|
163
163
|
|------|-------------|
|
|
164
164
|
| `simulate_transaction` | Pre-sign simulation check |
|
|
165
|
-
|
|
166
|
-
### Resolution Status (3 tools)
|
|
167
|
-
| Tool | Description |
|
|
168
|
-
|------|-------------|
|
|
169
165
|
| `get_resolution_status` | Market resolution state |
|
|
170
166
|
| `get_disputed_markets` | List disputed markets |
|
|
171
167
|
| `get_markets_awaiting_resolution` | Pending resolution markets |
|
|
@@ -209,39 +205,6 @@ npx @baozi/mcp-server
|
|
|
209
205
|
}
|
|
210
206
|
```
|
|
211
207
|
|
|
212
|
-
### Validate Market Before Creation
|
|
213
|
-
```json
|
|
214
|
-
{
|
|
215
|
-
"name": "validate_market_params",
|
|
216
|
-
"arguments": {
|
|
217
|
-
"question": "Will BTC reach $100k in 2026?",
|
|
218
|
-
"closing_time": "2026-06-01T00:00:00Z",
|
|
219
|
-
"market_type": "event",
|
|
220
|
-
"event_time": "2026-07-01T00:00:00Z"
|
|
221
|
-
}
|
|
222
|
-
}
|
|
223
|
-
```
|
|
224
|
-
|
|
225
|
-
## Transaction Signing
|
|
226
|
-
|
|
227
|
-
The MCP server returns unsigned transactions. Integration options:
|
|
228
|
-
|
|
229
|
-
### 1. Phantom Deep Link
|
|
230
|
-
```
|
|
231
|
-
phantom://sign?transaction={base64_tx}
|
|
232
|
-
```
|
|
233
|
-
|
|
234
|
-
### 2. Wallet Adapter (Web)
|
|
235
|
-
```typescript
|
|
236
|
-
const tx = Transaction.from(Buffer.from(base64Tx, 'base64'));
|
|
237
|
-
await wallet.signAndSendTransaction(tx);
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
### 3. Automated Wallets (Agents)
|
|
241
|
-
- [Turnkey](https://turnkey.com) - Policy-controlled signing
|
|
242
|
-
- [Crossmint](https://crossmint.com) - AI agent wallets
|
|
243
|
-
- [Privy](https://privy.io) - Embedded wallets
|
|
244
|
-
|
|
245
208
|
## Technical Details
|
|
246
209
|
|
|
247
210
|
| Parameter | Value |
|
|
@@ -260,34 +223,17 @@ await wallet.signAndSendTransaction(tx);
|
|
|
260
223
|
| Lab | 3% | 0.04 SOL |
|
|
261
224
|
| Private | 2% | 0.04 SOL |
|
|
262
225
|
|
|
263
|
-
## Development
|
|
264
|
-
|
|
265
|
-
```bash
|
|
266
|
-
# Install dependencies
|
|
267
|
-
npm install
|
|
268
|
-
|
|
269
|
-
# Build
|
|
270
|
-
npm run build
|
|
271
|
-
|
|
272
|
-
# Run locally
|
|
273
|
-
npm start
|
|
274
|
-
|
|
275
|
-
# Type check
|
|
276
|
-
npm run typecheck
|
|
277
|
-
```
|
|
278
|
-
|
|
279
|
-
## Environment Variables
|
|
280
|
-
|
|
281
|
-
| Variable | Description | Default |
|
|
282
|
-
|----------|-------------|---------|
|
|
283
|
-
| `HELIUS_RPC` | Custom RPC endpoint | Helius mainnet |
|
|
284
|
-
| `DEBUG` | Enable debug logging | false |
|
|
285
|
-
|
|
286
226
|
## Resources
|
|
287
227
|
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
228
|
+
| Resource | Link |
|
|
229
|
+
|----------|------|
|
|
230
|
+
| **Website** | https://baozi.ooo |
|
|
231
|
+
| **MCP Docs** | https://baozi.ooo/mcp |
|
|
232
|
+
| **SKILL.md** | https://github.com/bolivian-peru/baozi-mcp/blob/main/skills/SKILL.md |
|
|
233
|
+
| **npm** | https://www.npmjs.com/package/@baozi.bet/mcp-server |
|
|
234
|
+
| **GitHub** | https://github.com/bolivian-peru/baozi-mcp |
|
|
235
|
+
| **Twitter/X** | https://x.com/baikiemtien |
|
|
236
|
+
| **Solscan** | https://solscan.io/account/DW4o8AoSXnSudjZhwo4ixkmVUw2Bnv5FDPYF9LgsS5YY |
|
|
291
237
|
|
|
292
238
|
## License
|
|
293
239
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@baozi.bet/mcp-server",
|
|
3
|
-
"version": "4.0.
|
|
3
|
+
"version": "4.0.1",
|
|
4
4
|
"description": "MCP server for Baozi prediction markets on Solana - full protocol coverage with market creation and AI agent network",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -38,10 +38,14 @@
|
|
|
38
38
|
],
|
|
39
39
|
"author": "Baozi",
|
|
40
40
|
"license": "MIT",
|
|
41
|
+
"homepage": "https://baozi.ooo/mcp",
|
|
41
42
|
"repository": {
|
|
42
43
|
"type": "git",
|
|
43
44
|
"url": "https://github.com/bolivian-peru/baozi-mcp"
|
|
44
45
|
},
|
|
46
|
+
"bugs": {
|
|
47
|
+
"url": "https://github.com/bolivian-peru/baozi-mcp/issues"
|
|
48
|
+
},
|
|
45
49
|
"engines": {
|
|
46
50
|
"node": ">=18.0.0"
|
|
47
51
|
},
|