@0xmonaco/mcp-server 0.0.0-develop-20260220160207 → 0.0.0-develop-20260224233211
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 +30 -42
- package/dist/bin.js +143 -122
- package/package.json +10 -4
package/README.md
CHANGED
|
@@ -1,72 +1,55 @@
|
|
|
1
1
|
# @0xmonaco/mcp-server
|
|
2
2
|
|
|
3
|
-
MCP server for the Monaco SDK — gives AI assistants
|
|
3
|
+
MCP server for the Monaco SDK — gives AI assistants access to the Monaco protocol on Sei.
|
|
4
|
+
|
|
5
|
+
Works in **public-only mode** with zero configuration. Add a private key to unlock trading, deposits, withdrawals, and other authenticated tools.
|
|
4
6
|
|
|
5
7
|
## Configuration
|
|
6
8
|
|
|
7
9
|
| Variable | Required | Description |
|
|
8
10
|
|----------------------|----------|--------------------------------------------|
|
|
9
|
-
| `MONACO_PRIVATE_KEY` |
|
|
10
|
-
| `MONACO_CLIENT_ID` |
|
|
11
|
-
| `MONACO_NETWORK` | No | Network to connect to (default: `mainnet`)
|
|
12
|
-
| `MONACO_RPC_URL` |
|
|
11
|
+
| `MONACO_PRIVATE_KEY` | No | Wallet private key (`0x...`) — enables authenticated tools |
|
|
12
|
+
| `MONACO_CLIENT_ID` | No | Monaco application client ID — required with `MONACO_PRIVATE_KEY` |
|
|
13
|
+
| `MONACO_NETWORK` | No | Network to connect to (default: `mainnet`) |
|
|
14
|
+
| `MONACO_RPC_URL` | No | Sei RPC URL (defaults per network) |
|
|
13
15
|
|
|
14
16
|
### Networks
|
|
15
17
|
|
|
16
18
|
Set `MONACO_NETWORK` to one of the following:
|
|
17
19
|
|
|
18
|
-
| Network | API URL |
|
|
19
|
-
|
|
20
|
-
| `mainnet` (default) | `https://api.monaco.xyz` |
|
|
21
|
-
| `development` | `https://develop.apimonaco.xyz` |
|
|
22
|
-
| `staging` | `https://staging.apimonaco.xyz` |
|
|
23
|
-
| `local` | `http://localhost:8080` |
|
|
20
|
+
| Network | API URL | Default RPC URL |
|
|
21
|
+
|---------------------|---------------------------------|----------------------------------------|
|
|
22
|
+
| `mainnet` (default) | `https://api.monaco.xyz` | `https://evm-rpc.sei-apis.com` |
|
|
23
|
+
| `development` | `https://develop.apimonaco.xyz` | `https://evm-rpc-testnet.sei-apis.com` |
|
|
24
|
+
| `staging` | `https://staging.apimonaco.xyz` | `https://evm-rpc-testnet.sei-apis.com` |
|
|
25
|
+
| `local` | `http://localhost:8080` | `http://localhost:8545` |
|
|
24
26
|
|
|
25
27
|
## Installation
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
Add the following to your MCP config:
|
|
28
30
|
|
|
29
|
-
|
|
31
|
+
- **Cursor** — `~/.cursor/mcp.json`
|
|
32
|
+
- **Windsurf** — `~/.codeium/windsurf/mcp_config.json`
|
|
33
|
+
- **Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
|
30
34
|
|
|
31
|
-
|
|
32
|
-
{
|
|
33
|
-
"mcpServers": {
|
|
34
|
-
"monaco": {
|
|
35
|
-
"command": "npx",
|
|
36
|
-
"args": ["-y", "@0xmonaco/mcp-server"],
|
|
37
|
-
"env": {
|
|
38
|
-
"MONACO_PRIVATE_KEY": "0x...",
|
|
39
|
-
"MONACO_CLIENT_ID": "your-client-id",
|
|
40
|
-
"MONACO_RPC_URL": "https://evm-rpc.sei-apis.com"
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
```
|
|
35
|
+
### Public-only mode (no env vars needed)
|
|
46
36
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
Add to your `~/.codeium/windsurf/mcp_config.json`:
|
|
37
|
+
Market data, orderbook, trades, and docs search — no wallet required.
|
|
50
38
|
|
|
51
39
|
```json
|
|
52
40
|
{
|
|
53
41
|
"mcpServers": {
|
|
54
42
|
"monaco": {
|
|
55
43
|
"command": "npx",
|
|
56
|
-
"args": ["-y", "@0xmonaco/mcp-server"]
|
|
57
|
-
"env": {
|
|
58
|
-
"MONACO_PRIVATE_KEY": "0x...",
|
|
59
|
-
"MONACO_CLIENT_ID": "your-client-id",
|
|
60
|
-
"MONACO_RPC_URL": "https://evm-rpc.sei-apis.com"
|
|
61
|
-
}
|
|
44
|
+
"args": ["-y", "@0xmonaco/mcp-server"]
|
|
62
45
|
}
|
|
63
46
|
}
|
|
64
47
|
}
|
|
65
48
|
```
|
|
66
49
|
|
|
67
|
-
###
|
|
50
|
+
### Full access (with authentication)
|
|
68
51
|
|
|
69
|
-
|
|
52
|
+
All tools including trading, deposits, withdrawals, and profile.
|
|
70
53
|
|
|
71
54
|
```json
|
|
72
55
|
{
|
|
@@ -76,15 +59,14 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
|
|
|
76
59
|
"args": ["-y", "@0xmonaco/mcp-server"],
|
|
77
60
|
"env": {
|
|
78
61
|
"MONACO_PRIVATE_KEY": "0x...",
|
|
79
|
-
"MONACO_CLIENT_ID": "your-client-id"
|
|
80
|
-
"MONACO_RPC_URL": "https://evm-rpc.sei-apis.com"
|
|
62
|
+
"MONACO_CLIENT_ID": "your-client-id"
|
|
81
63
|
}
|
|
82
64
|
}
|
|
83
65
|
}
|
|
84
66
|
}
|
|
85
67
|
```
|
|
86
68
|
|
|
87
|
-
To connect to a non-mainnet network, add `MONACO_NETWORK` to the `env` block
|
|
69
|
+
To connect to a non-mainnet network, add `MONACO_NETWORK` to the `env` block (`mainnet`, `development`, `staging`, `local`). RPC URLs default automatically per network but can be overridden with `MONACO_RPC_URL`.
|
|
88
70
|
|
|
89
71
|
## Tools
|
|
90
72
|
|
|
@@ -152,3 +134,9 @@ To connect to a non-mainnet network, add `MONACO_NETWORK` to the `env` block wit
|
|
|
152
134
|
| `vault_withdraw` | Withdraw tokens from the vault |
|
|
153
135
|
| `vault_get_allowance` | Check current token allowance |
|
|
154
136
|
| `vault_needs_approval` | Check if approval is needed |
|
|
137
|
+
|
|
138
|
+
### Faucet (authenticated, non-mainnet only)
|
|
139
|
+
|
|
140
|
+
| Tool | Description |
|
|
141
|
+
|------------------|------------------------------------------|
|
|
142
|
+
| `request_faucet` | Request test funds for all trading pairs |
|