@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.
Files changed (3) hide show
  1. package/README.md +11 -10
  2. package/dist/bin.js +78 -78
  3. 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 preserved as the audit actor). Requires `MONACO_PRIVATE_KEY` + `MONACO_CLIENT_ID`. See [delegated owner mode](#delegated-owner-mode). |
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 preserved as the actor for audit. The owner must have registered
48
- this agent wallet with an active delegation policy; the server cannot self-assert ownership, and
49
- adoption fails if the agent is not authorized for that owner.
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://api.monaco.xyz` | `https://evm-rpc.sei-apis.com` |
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 filter). |
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 PitPass TraderCode handle is available (no credentials required). |
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) PitPass TraderCode handle. |
273
- | `clear_trader_code` | `market-maker` | Clear your custom PitPass TraderCode handle, reverting to the wallet-derived default. |
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