@magicblock-console/mcp 0.1.0 → 0.1.2
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 +89 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# @magicblock-console/mcp
|
|
2
|
+
|
|
3
|
+
MCP Server for managing [MagicBlock Ephemeral Rollups](https://www.magicblock.gg/) on Solana. Enables AI agents to manage ER infrastructure from any MCP-compatible client (Claude, Cursor, etc.).
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
Add to your MCP client configuration:
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"mcpServers": {
|
|
12
|
+
"magicblock-console": {
|
|
13
|
+
"command": "npx",
|
|
14
|
+
"args": ["@magicblock-console/mcp"]
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
For real blockchain operations, provide a keypair:
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"mcpServers": {
|
|
25
|
+
"magicblock-console": {
|
|
26
|
+
"command": "npx",
|
|
27
|
+
"args": ["@magicblock-console/mcp"],
|
|
28
|
+
"env": {
|
|
29
|
+
"MB_KEYPAIR_PATH": "~/.config/solana/id.json"
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Available Tools (20)
|
|
37
|
+
|
|
38
|
+
### Projects
|
|
39
|
+
| Tool | Description |
|
|
40
|
+
|------|-------------|
|
|
41
|
+
| `create_project` | Create a new project with ER configuration |
|
|
42
|
+
| `list_projects` | List all projects |
|
|
43
|
+
| `get_project` | Get project details |
|
|
44
|
+
| `configure_project` | Enable/disable features (gasless, privacy, vrf, cranks, oracle) |
|
|
45
|
+
| `delete_project` | Delete a project |
|
|
46
|
+
|
|
47
|
+
### ER Lifecycle
|
|
48
|
+
| Tool | Description |
|
|
49
|
+
|------|-------------|
|
|
50
|
+
| `delegate_account` | Delegate account to Ephemeral Rollup |
|
|
51
|
+
| `commit_account` | Commit ER state to Solana base layer |
|
|
52
|
+
| `undelegate_account` | Return account to Solana |
|
|
53
|
+
| `get_delegation_status` | Check delegation status |
|
|
54
|
+
| `list_delegated_accounts` | List delegated accounts |
|
|
55
|
+
| `get_state_diff` | Compare ER vs base layer state |
|
|
56
|
+
|
|
57
|
+
### Features
|
|
58
|
+
| Tool | Description |
|
|
59
|
+
|------|-------------|
|
|
60
|
+
| `request_vrf` | Request verifiable randomness |
|
|
61
|
+
| `create_crank` | Schedule automatic execution |
|
|
62
|
+
| `list_cranks` | List cranks |
|
|
63
|
+
| `stop_crank` | Stop a crank |
|
|
64
|
+
| `get_price_feed` | Get oracle price (SOL/USD, BTC/USD, etc.) |
|
|
65
|
+
| `deposit_private` | Deposit tokens to privacy layer (TEE) |
|
|
66
|
+
| `transfer_private` | Confidential token transfer |
|
|
67
|
+
| `withdraw_private` | Withdraw from privacy layer |
|
|
68
|
+
|
|
69
|
+
### Monitoring
|
|
70
|
+
| Tool | Description |
|
|
71
|
+
|------|-------------|
|
|
72
|
+
| `get_project_status` | Project status, uptime, tx count |
|
|
73
|
+
| `get_project_costs` | Cost breakdown by period |
|
|
74
|
+
| `get_project_logs` | Recent log entries |
|
|
75
|
+
|
|
76
|
+
## Example
|
|
77
|
+
|
|
78
|
+
> "Create a project called my-game in the US region with gasless and VRF enabled"
|
|
79
|
+
|
|
80
|
+
The agent will call `create_project` and `configure_project` to set everything up.
|
|
81
|
+
|
|
82
|
+
## Related Packages
|
|
83
|
+
|
|
84
|
+
- [`@magicblock-console/core`](https://www.npmjs.com/package/@magicblock-console/core) — Core SDK
|
|
85
|
+
- [`@magicblock-console/cli`](https://www.npmjs.com/package/@magicblock-console/cli) — Terminal interface
|
|
86
|
+
|
|
87
|
+
## License
|
|
88
|
+
|
|
89
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@magicblock-console/mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "MCP server for MagicBlock Ephemeral Rollups — AI agent integration via Model Context Protocol",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"files": ["dist"],
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
"lint": "tsc --noEmit"
|
|
17
17
|
},
|
|
18
18
|
"dependencies": {
|
|
19
|
-
"@magicblock-console/core": "
|
|
19
|
+
"@magicblock-console/core": "^0.1.0",
|
|
20
20
|
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
21
21
|
"zod": "^3.23.0"
|
|
22
22
|
},
|