gate-mcp 0.4.1 → 0.5.0

package/README.md

@@ -1,17 +1,18 @@
 # gate-local-mcp
 
-A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com) API v4 to any MCP-compatible client (Claude Desktop, etc.).
+A local (stdio) MCP server that exposes the full [Gate](https://www.gate.com) API v4 to any MCP-compatible client (Claude Desktop, etc.).
 
-**Quickstart guides:** [English](quickstart.md) · [中文](quickstart_zh.md)
+**Quickstart guides:** [English](docs/quickstart.md) · [中文](docs/quickstart_zh.md)
 
 > **Looking for the remote MCP server?** If you need HTTP/SSE-based remote access instead of local stdio, see [gate/gate-mcp](https://github.com/gate/gate-mcp).
 
 ## Features
 
-- **148 tools** covering Spot, Futures, Delivery, Margin, Wallet, Account, Options, Earn, Flash Swap, Unified, and Sub-Account APIs
+- **161 tools** covering Spot, Futures, Delivery, Margin, Wallet, Account, Options, Earn, Flash Swap, Unified, and Sub-Account APIs
 - **Zero config for public endpoints** — market data, tickers, order books work without any credentials
 - **Authenticated endpoints** — trading, wallet, and account tools activate automatically when `GATE_API_KEY` + `GATE_API_SECRET` env vars are set
 - **Testnet support** — set `GATE_BASE_URL` to use the testnet endpoint
+- **Module filtering** — load only the modules you need via `GATE_MODULES` or `--modules`; use `GATE_READONLY` or `--readonly` to restrict to read-only tools
 
 ## Quick Start (Claude Desktop)
 
@@ -63,6 +64,53 @@ A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com
 }
 ```
 
+## Module Filtering
+
+By default all 161 tools (11 modules) are registered. To reduce the tool count (e.g. Cursor warns above 80), restrict to specific modules:
+
+**CLI flags:**
+```bash
+# Load only spot and futures tools (73 tools)
+GATE_API_KEY=... npx gate-mcp --modules=spot,futures
+
+# Load futures tools in read-only mode (26 tools)
+npx gate-mcp --modules=futures --readonly
+```
+
+**MCP config (env vars):**
+```json
+{
+  "mcpServers": {
+    "gate": {
+      "command": "npx",
+      "args": ["-y", "gate-mcp"],
+      "env": {
+        "GATE_MODULES": "spot,futures",
+        "GATE_READONLY": "true",
+        "GATE_API_KEY": "your-api-key",
+        "GATE_API_SECRET": "your-api-secret"
+      }
+    }
+  }
+}
+```
+
+**Available modules:** `spot`, `futures`, `delivery`, `margin`, `wallet`, `account`, `options`, `earn`, `flash_swap`, `unified`, `sub_account`
+
+| Module | Total | Read-only |
+|---|---|---|
+| spot | 28 | 18 |
+| futures | 45 | 26 |
+| delivery | 11 | 9 |
+| margin | 5 | 4 |
+| wallet | 12 | 9 |
+| account | 10 | 6 |
+| options | 13 | 11 |
+| earn | 5 | 5 |
+| flash_swap | 5 | 4 |
+| unified | 16 | 12 |
+| sub_account | 11 | 5 |
+
 ## Environment Variables
 
 | Variable | Required | Default | Description |
@@ -70,41 +118,45 @@ A local (stdio) MCP server that exposes the full [Gate.com](https://www.gate.com
 | `GATE_API_KEY` | No | — | API key for authenticated endpoints |
 | `GATE_API_SECRET` | No | — | API secret for authenticated endpoints |
 | `GATE_BASE_URL` | No | `https://api.gateio.ws` | Override base URL (e.g. for testnet) |
+| `GATE_MODULES` | No | all modules | Comma-separated list of modules to load (e.g. `spot,futures`) |
+| `GATE_READONLY` | No | `false` | Set to `true` to disable all write (order/transfer) tools |
 
 ## Available Tools
 
+Tools marked `*` require authentication (`GATE_API_KEY` + `GATE_API_SECRET`).
+
 ### Spot (28 tools)
-`list_currencies`, `get_currency`, `list_currency_pairs`, `get_currency_pair`, `list_tickers`, `list_order_book`, `list_trades`, `list_candlesticks`, `get_fee`*, `list_spot_accounts`*, `list_spot_account_book`*, `list_orders`*, `create_order`*, `get_order`*, `cancel_order`*, `amend_order`*, `cancel_orders`*, `create_batch_orders`*, `cancel_batch_orders`*, `get_batch_spot_fee`*, `list_my_trades`*, `list_all_open_orders`*, `list_spot_price_triggered_orders`*, `create_spot_price_triggered_order`*, `get_spot_price_triggered_order`*, `cancel_spot_price_triggered_order`*, `cancel_spot_price_triggered_order_list`*, `countdown_cancel_all_spot`*
+`cex_spot_list_currencies`, `cex_spot_get_currency`, `cex_spot_list_currency_pairs`, `cex_spot_get_currency_pair`, `cex_spot_get_spot_tickers`, `cex_spot_get_spot_order_book`, `cex_spot_get_spot_trades`, `cex_spot_get_spot_candlesticks`, `cex_spot_get_spot_fee`\*, `cex_spot_get_spot_accounts`\*, `cex_spot_list_spot_account_book`\*, `cex_spot_list_spot_orders`\*, `cex_spot_create_spot_order`\*, `cex_spot_get_spot_order`\*, `cex_spot_cancel_spot_order`\*, `cex_spot_amend_spot_order`\*, `cex_spot_cancel_all_spot_orders`\*, `cex_spot_create_spot_batch_orders`\*, `cex_spot_cancel_spot_batch_orders`\*, `cex_spot_get_spot_batch_fee`\*, `cex_spot_list_spot_my_trades`\*, `cex_spot_list_all_open_orders`\*, `cex_spot_list_spot_price_triggered_orders`\*, `cex_spot_create_spot_price_triggered_order`\*, `cex_spot_get_spot_price_triggered_order`\*, `cex_spot_cancel_spot_price_triggered_order`\*, `cex_spot_cancel_spot_price_triggered_order_list`\*, `cex_spot_countdown_cancel_all_spot`\*
 
-### Futures (37 tools)
-`list_futures_contracts`, `get_futures_contract`, `list_futures_order_book`, `list_futures_candlesticks`, `list_futures_tickers`, `list_futures_funding_rate_history`, `list_futures_trades`, `list_contract_stats`, `list_futures_premium_index`, `list_futures_accounts`*, `list_futures_account_book`*, `get_futures_fee`*, `list_positions`*, `get_position`*, `get_leverage`*, `update_position_leverage`*, `update_position_margin`*, `update_position_risk_limit`*, `list_futures_orders`*, `create_futures_order`*, `get_futures_order`*, `cancel_futures_order`*, `cancel_futures_orders`*, `amend_futures_order`*, `create_batch_futures_orders`*, `cancel_batch_futures_orders`*, `get_futures_orders_with_time_range`*, `get_my_futures_trades`*, `get_my_futures_trades_with_time_range`*, `list_position_close`*, `list_liquidates`*, `list_price_triggered_orders`*, `create_futures_price_triggered_order`*, `get_futures_price_triggered_order`*, `cancel_futures_price_triggered_order`*, `cancel_futures_price_triggered_order_list`*, `countdown_cancel_all_futures`*
+### Futures (45 tools) — prefix abbreviated to `cex_fx_`
+`cex_fx_list_fx_contracts`, `cex_fx_get_fx_contract`, `cex_fx_get_fx_order_book`, `cex_fx_get_fx_candlesticks`, `cex_fx_get_fx_tickers`, `cex_fx_get_fx_funding_rate`, `cex_fx_get_fx_trades`, `cex_fx_list_contract_stats`, `cex_fx_get_fx_premium_index`, `cex_fx_get_fx_accounts`\*, `cex_fx_list_fx_account_book`\*, `cex_fx_get_fx_fee`\*, `cex_fx_list_fx_positions`\*, `cex_fx_get_fx_position`\*, `cex_fx_get_leverage`\*, `cex_fx_update_fx_position_leverage`\*, `cex_fx_update_fx_position_margin`\*, `cex_fx_update_fx_position_risk_limit`\*, `cex_fx_list_fx_orders`\*, `cex_fx_create_fx_order`\*, `cex_fx_get_fx_order`\*, `cex_fx_cancel_fx_order`\*, `cex_fx_cancel_all_fx_orders`\*, `cex_fx_amend_fx_order`\*, `cex_fx_create_fx_batch_orders`\*, `cex_fx_cancel_fx_batch_orders`\*, `cex_fx_get_fx_orders_with_time_range`\*, `cex_fx_list_fx_my_trades`\*, `cex_fx_get_fx_my_trades_timerange`\*, `cex_fx_list_position_close`\*, `cex_fx_list_fx_liq_orders`\*, `cex_fx_list_price_triggered_orders`\*, `cex_fx_create_fx_price_triggered_order`\*, `cex_fx_get_fx_price_triggered_order`\*, `cex_fx_cancel_fx_price_triggered_order`\*, `cex_fx_cancel_fx_price_triggered_order_list`\*, `cex_fx_countdown_cancel_all_fx`\*, `cex_fx_list_fx_risk_limit_tiers`\*, `cex_fx_set_fx_dual`\*, `cex_fx_get_fx_dual_position`\*, `cex_fx_update_fx_dual_position_margin`\*, `cex_fx_update_fx_dual_position_leverage`\*, `cex_fx_update_fx_dual_position_risk_limit`\*, `cex_fx_update_fx_position_cross_mode`\*, `cex_fx_update_fx_dual_position_cross_mode`\*
 
 ### Delivery (11 tools)
-`list_delivery_contracts`, `get_delivery_contract`, `list_delivery_order_book`, `list_delivery_candlesticks`, `list_delivery_tickers`, `list_delivery_accounts`*, `list_delivery_positions`*, `list_delivery_orders`*, `create_delivery_order`*, `cancel_delivery_order`*, `get_my_delivery_trades`*
+`cex_delivery_list_delivery_contracts`, `cex_delivery_get_delivery_contract`, `cex_delivery_list_delivery_order_book`, `cex_delivery_list_delivery_candlesticks`, `cex_delivery_list_delivery_tickers`, `cex_delivery_list_delivery_accounts`\*, `cex_delivery_list_delivery_positions`\*, `cex_delivery_list_delivery_orders`\*, `cex_delivery_create_delivery_order`\*, `cex_delivery_cancel_delivery_order`\*, `cex_delivery_get_my_delivery_trades`\*
 
 ### Margin (5 tools)
-`list_margin_accounts`*, `list_margin_account_book`*, `get_auto_repay_status`*, `set_auto_repay`*, `get_margin_transferable`*
+`cex_margin_list_margin_accounts`\*, `cex_margin_list_margin_account_book`\*, `cex_margin_get_auto_repay_status`\*, `cex_margin_set_auto_repay`\*, `cex_margin_get_margin_transferable`\*
 
-### Wallet (9 tools)
-`get_total_balance`*, `list_withdrawals`*, `list_deposits`*, `get_deposit_address`*, `transfer`*, `list_sub_account_balances`*, `get_trade_fee`*, `list_currency_chains`, `list_withdraw_status`*
+### Wallet (12 tools)
+`cex_wallet_list_currency_chains`, `cex_wallet_get_total_balance`\*, `cex_wallet_list_withdrawals`\*, `cex_wallet_list_deposits`\*, `cex_wallet_get_deposit_address`\*, `cex_wallet_create_transfer`\*, `cex_wallet_list_sa_balances`\*, `cex_wallet_get_wallet_fee`\*, `cex_wallet_create_sa_transfer`\*, `cex_wallet_create_sa_to_sa_transfer`\*, `cex_wallet_get_transfer_order_status`\*, `cex_wallet_list_withdraw_status`\*
 
 ### Account (10 tools)
-`get_account_detail`*, `get_account_rate_limit`*, `get_debit_fee`*, `set_debit_fee`*, `get_account_main_keys`*, `list_stp_groups`*, `create_stp_group`*, `list_stp_group_users`*, `add_stp_group_users`*, `delete_stp_group_user`*
+`cex_account_get_account_detail`\*, `cex_account_get_account_rate_limit`\*, `cex_account_get_debit_fee`\*, `cex_account_set_debit_fee`\*, `cex_account_get_account_main_keys`\*, `cex_account_list_stp_groups`\*, `cex_account_create_stp_group`\*, `cex_account_list_stp_group_users`\*, `cex_account_add_stp_group_users`\*, `cex_account_delete_stp_group_user`\*
 
 ### Options (13 tools)
-`list_options_underlyings`, `list_options_expirations`, `list_options_contracts`, `get_options_contract`, `list_options_order_book`, `list_options_tickers`, `list_options_candlesticks`, `list_options_account`*, `list_options_positions`*, `list_options_orders`*, `create_options_order`*, `cancel_options_order`*, `list_my_options_trades`*
+`cex_options_list_options_underlyings`, `cex_options_list_options_expirations`, `cex_options_list_options_contracts`, `cex_options_get_options_contract`, `cex_options_list_options_order_book`, `cex_options_list_options_tickers`, `cex_options_list_options_candlesticks`, `cex_options_list_options_account`\*, `cex_options_list_options_positions`\*, `cex_options_list_options_orders`\*, `cex_options_create_options_order`\*, `cex_options_cancel_options_order`\*, `cex_options_list_my_options_trades`\*
 
 ### Earn (5 tools)
-`list_dual_investment_plans`, `list_dual_orders`*, `list_dual_balance`*, `list_structured_products`, `list_structured_orders`*
+`cex_earn_list_dual_investment_plans`, `cex_earn_list_structured_products`, `cex_earn_list_dual_orders`\*, `cex_earn_list_dual_balance`\*, `cex_earn_list_structured_orders`\*
 
-### Flash Swap (5 tools)
-`list_flash_swap_currency_pairs`, `preview_flash_swap_order`*, `create_flash_swap_order`*, `list_flash_swap_orders`*, `get_flash_swap_order`*
+### Flash Swap (5 tools) — prefix abbreviated to `cex_fc_`
+`cex_fc_list_fc_currency_pairs`, `cex_fc_preview_fc_order`\*, `cex_fc_create_fc_order`\*, `cex_fc_list_fc_orders`\*, `cex_fc_get_fc_order`\*
 
 ### Unified Account (16 tools)
-`list_unified_accounts`*, `list_unified_currencies`*, `get_unified_mode`*, `set_unified_mode`*, `get_unified_risk_units`*, `get_unified_borrowable`*, `get_unified_transferable`*, `get_unified_estimate_rate`*, `list_unified_loans`*, `create_unified_loan`*, `list_unified_loan_records`*, `list_unified_loan_interest_records`*, `list_currency_discount_tiers`, `get_user_leverage_currency_setting`*, `set_user_leverage_currency_setting`*, `set_unified_collateral`*
+`cex_unified_list_currency_discount_tiers`, `cex_unified_get_unified_accounts`\*, `cex_unified_list_unified_currencies`\*, `cex_unified_get_unified_mode`\*, `cex_unified_set_unified_mode`\*, `cex_unified_get_unified_risk_units`\*, `cex_unified_get_unified_borrowable`\*, `cex_unified_get_unified_transferable`\*, `cex_unified_get_unified_estimate_rate`\*, `cex_unified_list_unified_loans`\*, `cex_unified_create_unified_loan`\*, `cex_unified_list_unified_loan_records`\*, `cex_unified_list_unified_loan_interest_records`\*, `cex_unified_get_user_leverage_currency_setting`\*, `cex_unified_set_user_leverage_currency_setting`\*, `cex_unified_set_unified_collateral`\*
 
-### Sub-Account (9 tools)
-`list_sub_accounts`*, `create_sub_account`*, `get_sub_account`*, `lock_sub_account`*, `unlock_sub_account`*, `list_sub_account_keys`*, `get_sub_account_key`*, `create_sub_account_keys`*, `delete_sub_account_key`*
+### Sub-Account (11 tools) — prefix abbreviated to `cex_sa_`
+`cex_sa_list_sas`\*, `cex_sa_create_sa`\*, `cex_sa_get_sa`\*, `cex_sa_lock_sa`\*, `cex_sa_unlock_sa`\*, `cex_sa_list_sa_keys`\*, `cex_sa_get_sa_key`\*, `cex_sa_create_sa_key`\*, `cex_sa_update_sa_key`\*, `cex_sa_get_sa_unified_mode`\*, `cex_sa_delete_sa_key`\*
 
 *\* Requires authentication (`GATE_API_KEY` + `GATE_API_SECRET`)*
 
@@ -133,7 +185,7 @@ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":
 
 # Get BTC_USDT ticker (public, no auth)
 echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}
-{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_tickers","arguments":{"currency_pair":"BTC_USDT"}}}' | node dist/index.js
+{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"cex_spot_get_spot_tickers","arguments":{"currency_pair":"BTC_USDT"}}}' | node dist/index.js
 ```
 
 ## License

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export declare const VALID_MODULES: readonly ["spot", "futures", "delivery", "margin", "wallet", "account", "options", "earn", "flash_swap", "unified", "sub_account"];
+export type ModuleName = typeof VALID_MODULES[number];
+export interface ServerConfig {
+    /** null means all modules */
+    modules: Set<ModuleName> | null;
+    readonly: boolean;
+}
+export declare function parseConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,oIAGhB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,WAAW,IAAI,YAAY,CAyC1C"}

package/dist/config.js

@@ -0,0 +1,45 @@
+export const VALID_MODULES = [
+    'spot', 'futures', 'delivery', 'margin', 'wallet',
+    'account', 'options', 'earn', 'flash_swap', 'unified', 'sub_account',
+];
+export function parseConfig() {
+    // --- readonly ---
+    let readonly = process.env.GATE_READONLY === 'true';
+    if (process.argv.includes('--readonly'))
+        readonly = true;
+    // --- modules ---
+    // CLI flag: --modules=spot,futures  OR  --modules spot,futures
+    let modulesRaw = process.env.GATE_MODULES;
+    const flagIndex = process.argv.findIndex(a => a.startsWith('--modules'));
+    if (flagIndex !== -1) {
+        const arg = process.argv[flagIndex];
+        if (arg.includes('=')) {
+            modulesRaw = arg.split('=')[1];
+        }
+        else if (process.argv[flagIndex + 1] && !process.argv[flagIndex + 1].startsWith('--')) {
+            modulesRaw = process.argv[flagIndex + 1];
+        }
+        else {
+            console.error(`[gate-mcp] --modules flag requires a value (e.g. --modules=spot,futures). Loading all modules.`);
+        }
+    }
+    if (!modulesRaw || modulesRaw.trim() === '') {
+        return { modules: null, readonly };
+    }
+    const requested = modulesRaw.split(',').map(s => s.trim().toLowerCase());
+    const valid = new Set();
+    for (const name of requested) {
+        if (VALID_MODULES.includes(name)) {
+            valid.add(name);
+        }
+        else {
+            console.error(`[gate-mcp] Unknown module "${name}" — ignored. Valid modules: ${VALID_MODULES.join(', ')}`);
+        }
+    }
+    if (valid.size === 0) {
+        console.error('[gate-mcp] No valid modules specified — loading all modules.');
+        return { modules: null, readonly };
+    }
+    return { modules: valid, readonly };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ;IACjD,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa;CAC5D,CAAC;AAUX,MAAM,UAAU,WAAW;IACzB,mBAAmB;IACnB,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;IACpD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,QAAQ,GAAG,IAAI,CAAC;IAEzD,kBAAkB;IAClB,+DAA+D;IAC/D,IAAI,UAAU,GAAuB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAE9D,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACzE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxF,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,gGAAgG,CAAC,CAAC;QAClH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAc,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAK,aAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,GAAG,CAAC,IAAkB,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,+BAA+B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { sanitizeToolName } from './utils.js';
+import { sanitizeToolName, isWriteTool } from './utils.js';
+import { parseConfig } from './config.js';
 import { registerSpotTools } from './tools/spot.js';
 import { registerFuturesTools } from './tools/futures.js';
 import { registerDeliveryTools } from './tools/delivery.js';
@@ -13,24 +14,40 @@ import { registerEarnTools } from './tools/earn.js';
 import { registerFlashSwapTools } from './tools/flash_swap.js';
 import { registerUnifiedTools } from './tools/unified.js';
 import { registerSubAccountTools } from './tools/sub_account.js';
+const config = parseConfig();
 const server = new McpServer({
     name: 'gate',
     version: '0.1.0',
 });
-// Apply NAME_ABBREVIATIONS to every tool name at registration time.
+// Monkey-patch server.tool: apply name sanitization + readonly filter
 const _registerTool = server.tool.bind(server);
-server.tool = (name, ...args) => _registerTool(sanitizeToolName(name), ...args);
-registerSpotTools(server);
-registerFuturesTools(server);
-registerDeliveryTools(server);
-registerMarginTools(server);
-registerWalletTools(server);
-registerAccountTools(server);
-registerOptionsTools(server);
-registerEarnTools(server);
-registerFlashSwapTools(server);
-registerUnifiedTools(server);
-registerSubAccountTools(server);
+server.tool = (name, ...args) => {
+    const sanitized = sanitizeToolName(name);
+    if (config.readonly && isWriteTool(sanitized))
+        return;
+    _registerTool(sanitized, ...args);
+};
+const MODULE_REGISTRY = {
+    spot: registerSpotTools,
+    futures: registerFuturesTools,
+    delivery: registerDeliveryTools,
+    margin: registerMarginTools,
+    wallet: registerWalletTools,
+    account: registerAccountTools,
+    options: registerOptionsTools,
+    earn: registerEarnTools,
+    flash_swap: registerFlashSwapTools,
+    unified: registerUnifiedTools,
+    sub_account: registerSubAccountTools,
+};
+const modulesToLoad = config.modules ?? new Set(Object.keys(MODULE_REGISTRY));
+for (const name of modulesToLoad) {
+    MODULE_REGISTRY[name](server);
+}
+if (config.modules || config.readonly) {
+    const moduleList = config.modules ? [...config.modules].join(', ') : 'all';
+    console.error(`[gate-mcp] Modules: ${moduleList} | Readonly: ${config.readonly}`);
+}
 const transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,oEAAoE;AACpE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9C,MAAc,CAAC,IAAI,GAAG,CAAC,IAAY,EAAE,GAAG,IAAe,EAAE,EAAE,CACzD,aAA4D,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAEjG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAEhC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;AAE7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9C,MAAc,CAAC,IAAI,GAAG,CAAC,IAAY,EAAE,GAAG,IAAe,EAAE,EAAE;IAC1D,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,QAAQ,IAAI,WAAW,CAAC,SAAS,CAAC;QAAE,OAAO;IACrD,aAA4D,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;AACpF,CAAC,CAAC;AAEF,MAAM,eAAe,GAAoD;IACvE,IAAI,EAAS,iBAAiB;IAC9B,OAAO,EAAM,oBAAoB;IACjC,QAAQ,EAAK,qBAAqB;IAClC,MAAM,EAAO,mBAAmB;IAChC,MAAM,EAAO,mBAAmB;IAChC,OAAO,EAAM,oBAAoB;IACjC,OAAO,EAAM,oBAAoB;IACjC,IAAI,EAAS,iBAAiB;IAC9B,UAAU,EAAG,sBAAsB;IACnC,OAAO,EAAM,oBAAoB;IACjC,WAAW,EAAE,uBAAuB;CACrC,CAAC;AAEF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAiB,CAAC,CAAC;AAE9F,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;IACjC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,uBAAuB,UAAU,gBAAgB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/account.js

@@ -3,7 +3,7 @@ import { AccountApi } from 'gate-api';
 import { createClient, requireAuth } from '../client.js';
 import { textContent, errorContent } from '../utils.js';
 export function registerAccountTools(server) {
-    server.tool('cex.account.get_account_detail', 'Get account profile and configuration (requires authentication)', {}, async () => {
+    server.tool('cex_account_get_account_detail', 'Get account profile and configuration (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).getAccountDetail();
@@ -13,7 +13,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.get_account_rate_limit', 'Get account API rate limit information (requires authentication)', {}, async () => {
+    server.tool('cex_account_get_account_rate_limit', 'Get account API rate limit information (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).getAccountRateLimit();
@@ -23,7 +23,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.get_debit_fee', 'Get debit fee configuration (requires authentication)', {}, async () => {
+    server.tool('cex_account_get_debit_fee', 'Get debit fee configuration (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).getDebitFee();
@@ -33,7 +33,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.set_debit_fee', 'Enable or disable GT debit fee (requires authentication)', { enabled: z.boolean().describe('true to pay fees with GT, false to disable') }, async ({ enabled }) => {
+    server.tool('cex_account_set_debit_fee', 'Enable or disable GT debit fee (requires authentication)', { enabled: z.boolean().describe('true to pay fees with GT, false to disable') }, async ({ enabled }) => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).setDebitFee({ enabled });
@@ -43,7 +43,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.get_account_main_keys', 'Get main account API key info (requires authentication)', {}, async () => {
+    server.tool('cex_account_get_account_main_keys', 'Get main account API key info (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).getAccountMainKeys();
@@ -53,7 +53,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.list_stp_groups', 'List Self-Trade Prevention (STP) groups (requires authentication)', { name: z.string().optional().describe('Filter by group name') }, async ({ name }) => {
+    server.tool('cex_account_list_stp_groups', 'List Self-Trade Prevention (STP) groups (requires authentication)', { name: z.string().optional().describe('Filter by group name') }, async ({ name }) => {
         try {
             requireAuth();
             const opts = {};
@@ -66,7 +66,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.create_stp_group', 'Create a Self-Trade Prevention (STP) group (requires authentication)', { name: z.string().describe('STP group name') }, async ({ name }) => {
+    server.tool('cex_account_create_stp_group', 'Create a Self-Trade Prevention (STP) group (requires authentication)', { name: z.string().describe('STP group name') }, async ({ name }) => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).createSTPGroup({ name });
@@ -76,7 +76,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.list_stp_group_users', 'List users in an STP group (requires authentication)', { stp_id: z.number().int().describe('STP group ID') }, async ({ stp_id }) => {
+    server.tool('cex_account_list_stp_group_users', 'List users in an STP group (requires authentication)', { stp_id: z.number().int().describe('STP group ID') }, async ({ stp_id }) => {
         try {
             requireAuth();
             const { body } = await new AccountApi(createClient()).listSTPGroupsUsers(stp_id);
@@ -86,7 +86,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.add_stp_group_users', 'Add users to an STP group (requires authentication)', {
+    server.tool('cex_account_add_stp_group_users', 'Add users to an STP group (requires authentication)', {
         stp_id: z.number().int().describe('STP group ID'),
         user_ids: z.array(z.number().int()).describe('List of user IDs to add'),
     }, async ({ stp_id, user_ids }) => {
@@ -99,7 +99,7 @@ export function registerAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.account.delete_stp_group_user', 'Remove a user from an STP group (requires authentication)', {
+    server.tool('cex_account_delete_stp_group_user', 'Remove a user from an STP group (requires authentication)', {
         stp_id: z.number().int().describe('STP group ID'),
         user_id: z.number().int().describe('User ID to remove'),
     }, async ({ stp_id, user_id }) => {

package/dist/tools/delivery.js

@@ -6,7 +6,7 @@ import { textContent, errorContent } from '../utils.js';
 const settleSchema = z.literal('usdt').describe('Settlement currency (only usdt supported)');
 export function registerDeliveryTools(server) {
     // ── Public tools ──────────────────────────────────────────────────────────
-    server.tool('cex.delivery.list_delivery_contracts', 'List all delivery (expiring futures) contracts', { settle: settleSchema }, async ({ settle }) => {
+    server.tool('cex_delivery_list_delivery_contracts', 'List all delivery (expiring futures) contracts', { settle: settleSchema }, async ({ settle }) => {
         try {
             const { body } = await new DeliveryApi(createClient()).listDeliveryContracts(settle);
             return textContent(body);
@@ -15,7 +15,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.get_delivery_contract', 'Get a single delivery contract', {
+    server.tool('cex_delivery_get_delivery_contract', 'Get a single delivery contract', {
         settle: settleSchema,
         contract: z.string().describe('Contract name'),
     }, async ({ settle, contract }) => {
@@ -27,7 +27,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.list_delivery_order_book', 'Get delivery contract order book', {
+    server.tool('cex_delivery_list_delivery_order_book', 'Get delivery contract order book', {
         settle: settleSchema,
         contract: z.string().describe('Contract name'),
         limit: z.number().int().optional(),
@@ -43,7 +43,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.list_delivery_candlesticks', 'Get delivery contract candlestick data', {
+    server.tool('cex_delivery_list_delivery_candlesticks', 'Get delivery contract candlestick data', {
         settle: settleSchema,
         contract: z.string().describe('Contract name'),
         interval: z.enum(['1m', '5m', '15m', '30m', '1h', '4h', '8h', '1d']).optional(),
@@ -62,7 +62,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.list_delivery_tickers', 'Get delivery contract tickers', {
+    server.tool('cex_delivery_list_delivery_tickers', 'Get delivery contract tickers', {
         settle: settleSchema,
         contract: z.string().optional().describe('Filter by contract'),
     }, async ({ settle, contract }) => {
@@ -78,7 +78,7 @@ export function registerDeliveryTools(server) {
         }
     });
     // ── Private tools ─────────────────────────────────────────────────────────
-    server.tool('cex.delivery.list_delivery_accounts', 'Get delivery account balance (requires authentication)', { settle: settleSchema }, async ({ settle }) => {
+    server.tool('cex_delivery_list_delivery_accounts', 'Get delivery account balance (requires authentication)', { settle: settleSchema }, async ({ settle }) => {
         try {
             requireAuth();
             const { body } = await new DeliveryApi(createClient()).listDeliveryAccounts(settle);
@@ -88,7 +88,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.list_delivery_positions', 'List delivery positions (requires authentication)', { settle: settleSchema }, async ({ settle }) => {
+    server.tool('cex_delivery_list_delivery_positions', 'List delivery positions (requires authentication)', { settle: settleSchema }, async ({ settle }) => {
         try {
             requireAuth();
             const { body } = await new DeliveryApi(createClient()).listDeliveryPositions(settle);
@@ -98,7 +98,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.list_delivery_orders', 'List delivery orders (requires authentication)', {
+    server.tool('cex_delivery_list_delivery_orders', 'List delivery orders (requires authentication)', {
         settle: settleSchema,
         status: z.enum(['open', 'finished']),
         contract: z.string().optional(),
@@ -121,7 +121,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.create_delivery_order', 'Create a delivery order (requires authentication) — always confirm the details with the user before calling this tool', {
+    server.tool('cex_delivery_create_delivery_order', 'Create a delivery order (requires authentication) — always confirm the details with the user before calling this tool', {
         settle: settleSchema,
         contract: z.string().describe('Contract name'),
         size: z.number().int().describe('Order size (negative = short)'),
@@ -146,7 +146,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.cancel_delivery_order', 'Cancel a delivery order (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_delivery_cancel_delivery_order', 'Cancel a delivery order (requires authentication) — always confirm with the user before calling this tool', {
         settle: settleSchema,
         order_id: z.string().describe('Order ID'),
     }, async ({ settle, order_id }) => {
@@ -159,7 +159,7 @@ export function registerDeliveryTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.delivery.get_my_delivery_trades', 'Get personal delivery trading history (requires authentication)', {
+    server.tool('cex_delivery_get_my_delivery_trades', 'Get personal delivery trading history (requires authentication)', {
         settle: settleSchema,
         contract: z.string().optional(),
         limit: z.number().int().optional(),

package/dist/tools/earn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"earn.d.ts","sourceRoot":"","sources":["../../src/tools/earn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkGzD"}
+{"version":3,"file":"earn.d.ts","sourceRoot":"","sources":["../../src/tools/earn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmezD"}