@0xmonaco/mcp-server 1.0.81 → 1.0.83
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 +11 -10
- package/dist/bin.js +78 -78
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -17,7 +17,7 @@ supplying a key does **not** blindly unlock the entire tool set.
|
|
|
17
17
|
| `MONACO_TOOL_ALLOWLIST`| No | Comma-separated tool names to enable on top of the profile (explicit per-tool opt-in, e.g. a single fund-movement tool). |
|
|
18
18
|
| `MONACO_TOOL_DENYLIST` | No | Comma-separated tool names to disable. Wins over the profile and the allowlist. |
|
|
19
19
|
| `MONACO_RPC_URL` | No | Sei RPC URL (defaults per network) |
|
|
20
|
-
| `MONACO_DELEGATED_OWNER_USER_ID` | No | Run on behalf of a delegated **owner** account. The `MONACO_PRIVATE_KEY` wallet is the agent; on startup it authenticates as itself, then adopts an owner-scoped session so every tool call acts on the owner (agent
|
|
20
|
+
| `MONACO_DELEGATED_OWNER_USER_ID` | No | Run on behalf of a delegated **owner** account. The `MONACO_PRIVATE_KEY` wallet is the agent; on startup it authenticates as itself, then adopts an owner-scoped session so every tool call acts on the owner (the agent wallet stays the session's actor for policy enforcement; orders carry the owner's wallet). Requires `MONACO_PRIVATE_KEY` + `MONACO_CLIENT_ID`. See [delegated owner mode](#delegated-owner-mode). |
|
|
21
21
|
|
|
22
22
|
## Capability profiles
|
|
23
23
|
|
|
@@ -44,9 +44,10 @@ Set `MONACO_DELEGATED_OWNER_USER_ID` to act on behalf of a delegated owner accou
|
|
|
44
44
|
the configured wallet's own account. The wallet in `MONACO_PRIVATE_KEY` is the **agent**: on
|
|
45
45
|
startup it authenticates as itself, then adopts an owner-scoped delegated session
|
|
46
46
|
(`loginAsDelegatedOwner`). Every subsequent tool call — reads and trades — acts on the owner
|
|
47
|
-
account, with the agent wallet
|
|
48
|
-
this
|
|
49
|
-
|
|
47
|
+
account, with the agent wallet kept as the session's actor for policy enforcement. Orders placed
|
|
48
|
+
this way carry the owner's wallet, not the agent's, so order history does not record the agent.
|
|
49
|
+
The owner must have registered this agent wallet with an active delegation policy; the server
|
|
50
|
+
cannot self-assert ownership, and adoption fails if the agent is not authorized for that owner.
|
|
50
51
|
|
|
51
52
|
This is fail-closed: `MONACO_DELEGATED_OWNER_USER_ID` requires `MONACO_PRIVATE_KEY` and
|
|
52
53
|
`MONACO_CLIENT_ID`, a blank value is rejected, and if owner adoption fails the server does not
|
|
@@ -61,7 +62,7 @@ For public endpoints, set `MONACO_NETWORK` to one of the following documented va
|
|
|
61
62
|
|
|
62
63
|
| Network | API URL | Default RPC URL |
|
|
63
64
|
|---------------------|---------------------------------|----------------------------------------|
|
|
64
|
-
| `mainnet` (default) | `https://
|
|
65
|
+
| `mainnet` (default) | `https://apimonaco.xyz` | `https://evm-rpc.sei-apis.com` |
|
|
65
66
|
| `staging` | `https://staging.apimonaco.xyz` | `https://evm-rpc-testnet.sei-apis.com` |
|
|
66
67
|
|
|
67
68
|
## Installation
|
|
@@ -149,7 +150,7 @@ profile each tool needs.
|
|
|
149
150
|
| `get_mark_price` | Public | Get the current mark price for a perpetual market. |
|
|
150
151
|
| `get_index_price` | Public | Get the current index (oracle) price for a perpetual market. |
|
|
151
152
|
| `get_funding_state` | Public | Get the current funding rate and next funding time for a perpetual market. |
|
|
152
|
-
| `get_open_interest` | Public | Get the current open interest for a perpetual market. |
|
|
153
|
+
| `get_open_interest` | Public | Get the current gross open interest (longs plus shorts) for a perpetual market. |
|
|
153
154
|
| `get_funding_history` | Public | List historical funding-rate records for a perpetual market. |
|
|
154
155
|
| `get_all_funding_history` | Public | List historical funding-rate records across all perpetual markets. |
|
|
155
156
|
|
|
@@ -177,7 +178,7 @@ Order reads (`get_orders`, `get_order`) are available under `read`; the mutation
|
|
|
177
178
|
| `cancel_order` | `market-maker` | Cancel a single order by ID. |
|
|
178
179
|
| `batch_cancel_orders` | `market-maker` | Cancel multiple orders by ID (non-atomic — a failed leg does not stop the others). |
|
|
179
180
|
| `batch_cancel_all_orders` | `market-maker` | Cancel all open orders, optionally filtered to a trading pair (unfiltered, it cancels your entire open-order book). |
|
|
180
|
-
| `batch_close_all_positions` | `market-maker` | Close all open perpetual positions with market reduce-only orders (best-effort, optional pair
|
|
181
|
+
| `batch_close_all_positions` | `market-maker` | Close all open perpetual positions with market reduce-only orders (best-effort, optional pair-set and side filters). |
|
|
181
182
|
| `get_orders` | `read` | List your orders with optional filters. |
|
|
182
183
|
| `get_order` | `read` | Get details for a specific order by ID. |
|
|
183
184
|
|
|
@@ -267,10 +268,10 @@ Testnet only — the faucet tools are never registered on `mainnet`.
|
|
|
267
268
|
| Tool | Profile | Description |
|
|
268
269
|
|------|---------|-------------|
|
|
269
270
|
| `get_trader_code_info` | Public | Look up a trader code's details (no credentials required). |
|
|
270
|
-
| `check_trader_code_availability` | Public | Public advisory check of whether a custom
|
|
271
|
+
| `check_trader_code_availability` | Public | Public advisory check of whether a custom TraderCode handle is available (no credentials required). |
|
|
271
272
|
| `get_my_trader_code` | `read` | Fetch your own trader code. |
|
|
272
|
-
| `set_trader_code` | `market-maker` | Claim or edit your custom (vanity)
|
|
273
|
-
| `clear_trader_code` | `market-maker` | Clear your custom
|
|
273
|
+
| `set_trader_code` | `market-maker` | Claim or edit your custom (vanity) TraderCode handle. |
|
|
274
|
+
| `clear_trader_code` | `market-maker` | Clear your custom TraderCode handle, reverting to the wallet-derived default. |
|
|
274
275
|
| `get_rewards_balance` | `read` | Fetch your TraderCodes rewards-bucket balances across reward tokens. |
|
|
275
276
|
| `transfer_rewards` | `full` | Move your earned TraderCodes rewards from the rewards bucket into your own tradeable balance (ledger-only). |
|
|
276
277
|
|