gate-mcp 0.4.1 → 0.4.3

package/dist/tools/spot.js

@@ -4,7 +4,7 @@ import { createClient, requireAuth } from '../client.js';
 import { textContent, errorContent } from '../utils.js';
 export function registerSpotTools(server) {
     // ── Public tools ──────────────────────────────────────────────────────────
-    server.tool('cex.spot.list_currencies', 'List all currencies supported on Gate.com', {}, async () => {
+    server.tool('cex_spot_list_currencies', 'List all currencies supported on Gate.com', {}, async () => {
         try {
             const { body } = await new SpotApi(createClient()).listCurrencies();
             return textContent(body);
@@ -13,7 +13,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_currency', 'Get details of a single currency', { currency: z.string().describe('Currency symbol e.g. BTC') }, async ({ currency }) => {
+    server.tool('cex_spot_get_currency', 'Get details of a single currency', { currency: z.string().describe('Currency symbol e.g. BTC') }, async ({ currency }) => {
         try {
             const { body } = await new SpotApi(createClient()).getCurrency(currency);
             return textContent(body);
@@ -22,7 +22,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.list_currency_pairs', 'List all available spot trading pairs', {}, async () => {
+    server.tool('cex_spot_list_currency_pairs', 'List all available spot trading pairs', {}, async () => {
         try {
             const { body } = await new SpotApi(createClient()).listCurrencyPairs();
             return textContent(body);
@@ -31,7 +31,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_currency_pair', 'Get details of a single currency pair', { currency_pair: z.string().describe('Currency pair e.g. BTC_USDT') }, async ({ currency_pair }) => {
+    server.tool('cex_spot_get_currency_pair', 'Get details of a single currency pair', { currency_pair: z.string().describe('Currency pair e.g. BTC_USDT') }, async ({ currency_pair }) => {
         try {
             const { body } = await new SpotApi(createClient()).getCurrencyPair(currency_pair);
             return textContent(body);
@@ -40,7 +40,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_tickers', 'Get ticker information for one or all currency pairs', {
+    server.tool('cex_spot_get_spot_tickers', 'Get ticker information for one or all currency pairs', {
         currency_pair: z.string().optional().describe('Limit to this pair e.g. BTC_USDT; omit for all'),
         timezone: z.enum(['utc0', 'utc8', 'all']).optional(),
     }, async ({ currency_pair, timezone }) => {
@@ -57,7 +57,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_order_book', 'Get the order book for a currency pair', {
+    server.tool('cex_spot_get_spot_order_book', 'Get the order book for a currency pair', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         limit: z.number().int().min(1).max(5000).optional().describe('Number of price levels (default 10)'),
         with_id: z.boolean().optional().describe('Include order book ID'),
@@ -75,7 +75,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_trades', 'Get recent trades for a currency pair', {
+    server.tool('cex_spot_get_spot_trades', 'Get recent trades for a currency pair', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         limit: z.number().int().min(1).max(1000).optional(),
     }, async ({ currency_pair, limit }) => {
@@ -90,7 +90,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_candlesticks', 'Get candlestick/OHLCV data for a currency pair', {
+    server.tool('cex_spot_get_spot_candlesticks', 'Get candlestick/OHLCV data for a currency pair', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         interval: z.enum(['10s', '1m', '5m', '15m', '30m', '1h', '4h', '8h', '1d', '7d', '30d']).optional().describe('Candlestick interval (default 30m)'),
         limit: z.number().int().min(1).max(1000).optional(),
@@ -114,7 +114,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_fee', 'Query user trading fee rates (requires authentication)', { currency_pair: z.string().optional().describe('Currency pair to query fee for') }, async ({ currency_pair }) => {
+    server.tool('cex_spot_get_spot_fee', 'Query user trading fee rates (requires authentication)', { currency_pair: z.string().optional().describe('Currency pair to query fee for') }, async ({ currency_pair }) => {
         try {
             requireAuth();
             const opts = {};
@@ -128,7 +128,7 @@ export function registerSpotTools(server) {
         }
     });
     // ── Private tools ─────────────────────────────────────────────────────────
-    server.tool('cex.spot.get_spot_accounts', 'List spot account balances (requires authentication)', { currency: z.string().optional().describe('Filter by currency symbol') }, async ({ currency }) => {
+    server.tool('cex_spot_get_spot_accounts', 'List spot account balances (requires authentication)', { currency: z.string().optional().describe('Filter by currency symbol') }, async ({ currency }) => {
         try {
             requireAuth();
             const opts = {};
@@ -141,7 +141,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.list_spot_orders', 'List spot orders (requires authentication)', {
+    server.tool('cex_spot_list_spot_orders', 'List spot orders (requires authentication)', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         status: z.enum(['open', 'finished']).optional().describe('Order status (default: open)'),
         page: z.number().int().min(1).optional(),
@@ -161,7 +161,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.create_spot_order', 'Create a spot order (requires authentication) — always confirm the details with the user before calling this tool', {
+    server.tool('cex_spot_create_spot_order', 'Create a spot order (requires authentication) — always confirm the details with the user before calling this tool', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         side: z.enum(['buy', 'sell']),
         amount: z.string().describe('Order amount'),
@@ -190,7 +190,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_order', 'Get details of a spot order (requires authentication)', {
+    server.tool('cex_spot_get_spot_order', 'Get details of a spot order (requires authentication)', {
         order_id: z.string().describe('Order ID'),
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
     }, async ({ order_id, currency_pair }) => {
@@ -203,7 +203,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.cancel_spot_order', 'Cancel a single spot order (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_spot_cancel_spot_order', 'Cancel a single spot order (requires authentication) — always confirm with the user before calling this tool', {
         order_id: z.string().describe('Order ID'),
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
     }, async ({ order_id, currency_pair }) => {
@@ -216,7 +216,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.amend_spot_order', 'Amend (modify) an open spot order (requires authentication) — always confirm the new values with the user before calling this tool', {
+    server.tool('cex_spot_amend_spot_order', 'Amend (modify) an open spot order (requires authentication) — always confirm the new values with the user before calling this tool', {
         order_id: z.string().describe('Order ID'),
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         amount: z.string().optional().describe('New order amount'),
@@ -236,7 +236,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.cancel_all_spot_orders', 'Cancel all open orders for a currency pair (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_spot_cancel_all_spot_orders', 'Cancel all open orders for a currency pair (requires authentication) — always confirm with the user before calling this tool', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         side: z.enum(['buy', 'sell']).optional().describe('Cancel only buy or sell orders'),
     }, async ({ currency_pair, side }) => {
@@ -252,7 +252,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.list_spot_my_trades', 'List personal trading history (requires authentication)', {
+    server.tool('cex_spot_list_spot_my_trades', 'List personal trading history (requires authentication)', {
         currency_pair: z.string().optional().describe('Filter by currency pair'),
         limit: z.number().int().min(1).max(1000).optional(),
         page: z.number().int().min(1).optional(),
@@ -273,7 +273,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.list_all_open_orders', 'List all open orders across all pairs (requires authentication)', { page: z.number().int().min(1).optional(), limit: z.number().int().min(1).max(100).optional() }, async ({ page, limit }) => {
+    server.tool('cex_spot_list_all_open_orders', 'List all open orders across all pairs (requires authentication)', { page: z.number().int().min(1).optional(), limit: z.number().int().min(1).max(100).optional() }, async ({ page, limit }) => {
         try {
             requireAuth();
             const opts = {};
@@ -288,7 +288,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.list_spot_price_triggered_orders', 'List price-triggered (stop) orders (requires authentication)', {
+    server.tool('cex_spot_list_spot_price_triggered_orders', 'List price-triggered (stop) orders (requires authentication)', {
         status: z.enum(['open', 'finished']).describe('Order status'),
         currency_pair: z.string().optional(),
         limit: z.number().int().optional(),
@@ -307,7 +307,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.list_spot_account_book', 'Query spot account transaction history (requires authentication)', {
+    server.tool('cex_spot_list_spot_account_book', 'Query spot account transaction history (requires authentication)', {
         currency: z.string().optional().describe('Filter by currency'),
         from: z.number().optional().describe('Start time (Unix timestamp)'),
         to: z.number().optional().describe('End time (Unix timestamp)'),
@@ -334,7 +334,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_batch_fee', 'Get fee rates for multiple currency pairs at once (requires authentication)', { currency_pairs: z.string().describe('Comma-separated currency pairs e.g. BTC_USDT,ETH_USDT') }, async ({ currency_pairs }) => {
+    server.tool('cex_spot_get_spot_batch_fee', 'Get fee rates for multiple currency pairs at once (requires authentication)', { currency_pairs: z.string().describe('Comma-separated currency pairs e.g. BTC_USDT,ETH_USDT') }, async ({ currency_pairs }) => {
         try {
             requireAuth();
             const { body } = await new SpotApi(createClient()).getBatchSpotFee(currency_pairs);
@@ -344,7 +344,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.create_spot_batch_orders', 'Create multiple spot orders in a single request (requires authentication) — always confirm the details with the user before calling this tool', {
+    server.tool('cex_spot_create_spot_batch_orders', 'Create multiple spot orders in a single request (requires authentication) — always confirm the details with the user before calling this tool', {
         orders: z.array(z.object({
             currency_pair: z.string(),
             side: z.enum(['buy', 'sell']),
@@ -378,7 +378,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.cancel_spot_batch_orders', 'Cancel multiple spot orders in a single request (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_spot_cancel_spot_batch_orders', 'Cancel multiple spot orders in a single request (requires authentication) — always confirm with the user before calling this tool', {
         orders: z.array(z.object({
             currency_pair: z.string(),
             id: z.string().describe('Order ID'),
@@ -400,7 +400,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.create_spot_price_triggered_order', 'Create a price-triggered (stop) spot order (requires authentication) — always confirm the details with the user before calling this tool', {
+    server.tool('cex_spot_create_spot_price_triggered_order', 'Create a price-triggered (stop) spot order (requires authentication) — always confirm the details with the user before calling this tool', {
         currency_pair: z.string().describe('Currency pair e.g. BTC_USDT'),
         trigger_price: z.string().describe('Price that activates the order'),
         trigger_rule: z.enum(['>=', '<=']).describe('>= fires when price rises to trigger_price; <= fires when price drops'),
@@ -433,7 +433,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.get_spot_price_triggered_order', 'Get details of a price-triggered spot order (requires authentication)', { order_id: z.string().describe('Order ID') }, async ({ order_id }) => {
+    server.tool('cex_spot_get_spot_price_triggered_order', 'Get details of a price-triggered spot order (requires authentication)', { order_id: z.string().describe('Order ID') }, async ({ order_id }) => {
         try {
             requireAuth();
             const { body } = await new SpotApi(createClient()).getSpotPriceTriggeredOrder(order_id);
@@ -443,7 +443,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.cancel_spot_price_triggered_order', 'Cancel a single price-triggered spot order (requires authentication) — always confirm with the user before calling this tool', { order_id: z.string().describe('Order ID') }, async ({ order_id }) => {
+    server.tool('cex_spot_cancel_spot_price_triggered_order', 'Cancel a single price-triggered spot order (requires authentication) — always confirm with the user before calling this tool', { order_id: z.string().describe('Order ID') }, async ({ order_id }) => {
         try {
             requireAuth();
             const { body } = await new SpotApi(createClient()).cancelSpotPriceTriggeredOrder(order_id);
@@ -453,7 +453,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.cancel_spot_price_triggered_order_list', 'Cancel all price-triggered spot orders (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_spot_cancel_spot_price_triggered_order_list', 'Cancel all price-triggered spot orders (requires authentication) — always confirm with the user before calling this tool', {
         currency_pair: z.string().optional().describe('Only cancel orders for this pair'),
         account: z.enum(['normal', 'margin', 'unified']).optional(),
     }, async ({ currency_pair, account }) => {
@@ -471,7 +471,7 @@ export function registerSpotTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.spot.countdown_cancel_all_spot', 'Set a countdown timer to cancel all spot orders (safety kill-switch, requires authentication)', {
+    server.tool('cex_spot_countdown_cancel_all_spot', 'Set a countdown timer to cancel all spot orders (safety kill-switch, requires authentication)', {
         timeout: z.number().int().describe('Countdown in seconds; 0 disables the timer'),
         currency_pair: z.string().optional().describe('Limit cancellation to this pair'),
     }, async ({ timeout, currency_pair }) => {

package/dist/tools/sub_account.js

@@ -3,7 +3,7 @@ import { SubAccountApi } from 'gate-api';
 import { createClient, requireAuth } from '../client.js';
 import { textContent, errorContent } from '../utils.js';
 export function registerSubAccountTools(server) {
-    server.tool('cex.sub_account.list_sub_accounts', 'List all sub-accounts (requires authentication)', { type: z.string().optional().describe('Filter by type: 0=normal, 1=pool') }, async ({ type }) => {
+    server.tool('cex_sub_account_list_sub_accounts', 'List all sub-accounts (requires authentication)', { type: z.string().optional().describe('Filter by type: 0=normal, 1=pool') }, async ({ type }) => {
         try {
             requireAuth();
             const opts = {};
@@ -16,7 +16,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.create_sub_account', 'Create a new sub-account (requires authentication) — always confirm the details with the user before calling this tool', {
+    server.tool('cex_sub_account_create_sub_account', 'Create a new sub-account (requires authentication) — always confirm the details with the user before calling this tool', {
         login_name: z.string().describe('Sub-account login name'),
         password: z.string().optional().describe('Sub-account password'),
         email: z.string().optional().describe('Sub-account email'),
@@ -38,7 +38,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.get_sub_account', 'Get details of a sub-account (requires authentication)', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
+    server.tool('cex_sub_account_get_sub_account', 'Get details of a sub-account (requires authentication)', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
         try {
             requireAuth();
             const { body } = await new SubAccountApi(createClient()).getSubAccount(user_id);
@@ -48,7 +48,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.lock_sub_account', 'Lock a sub-account to disable login and trading (requires authentication) — always confirm with the user before calling this tool', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
+    server.tool('cex_sub_account_lock_sub_account', 'Lock a sub-account to disable login and trading (requires authentication) — always confirm with the user before calling this tool', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
         try {
             requireAuth();
             const { body } = await new SubAccountApi(createClient()).lockSubAccount(user_id);
@@ -58,7 +58,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.unlock_sub_account', 'Unlock a previously locked sub-account (requires authentication) — always confirm with the user before calling this tool', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
+    server.tool('cex_sub_account_unlock_sub_account', 'Unlock a previously locked sub-account (requires authentication) — always confirm with the user before calling this tool', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
         try {
             requireAuth();
             const { body } = await new SubAccountApi(createClient()).unlockSubAccount(user_id);
@@ -68,7 +68,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.list_sub_account_keys', 'List API keys for a sub-account (requires authentication)', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
+    server.tool('cex_sub_account_list_sub_account_keys', 'List API keys for a sub-account (requires authentication)', { user_id: z.number().int().describe('Sub-account user ID') }, async ({ user_id }) => {
         try {
             requireAuth();
             const { body } = await new SubAccountApi(createClient()).listSubAccountKeys(user_id);
@@ -78,7 +78,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.get_sub_account_key', 'Get details of a specific API key for a sub-account (requires authentication)', {
+    server.tool('cex_sub_account_get_sub_account_key', 'Get details of a specific API key for a sub-account (requires authentication)', {
         user_id: z.number().int().describe('Sub-account user ID'),
         key: z.string().describe('API key'),
     }, async ({ user_id, key }) => {
@@ -91,7 +91,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.create_sub_account_key', 'Create API keys for a sub-account (requires authentication) — always confirm the permissions with the user before calling this tool', {
+    server.tool('cex_sub_account_create_sub_account_key', 'Create API keys for a sub-account (requires authentication) — always confirm the permissions with the user before calling this tool', {
         user_id: z.number().int().describe('Sub-account user ID'),
         name: z.string().optional().describe('API key name/label'),
         ip_whitelist: z.array(z.string()).optional().describe('Allowed IP addresses'),
@@ -110,7 +110,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.update_sub_account_key', 'Update an API key for a sub-account (requires authentication) — always confirm changes with the user before calling this tool', {
+    server.tool('cex_sub_account_update_sub_account_key', 'Update an API key for a sub-account (requires authentication) — always confirm changes with the user before calling this tool', {
         user_id: z.number().int().describe('Sub-account user ID'),
         key: z.string().describe('API key to update'),
         name: z.string().optional().describe('New API key name'),
@@ -138,7 +138,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.get_sub_account_unified_mode', 'Get the unified account mode for all sub-accounts (requires authentication)', {}, async () => {
+    server.tool('cex_sub_account_get_sub_account_unified_mode', 'Get the unified account mode for all sub-accounts (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new SubAccountApi(createClient()).listUnifiedMode();
@@ -148,7 +148,7 @@ export function registerSubAccountTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.sub_account.delete_sub_account_key', 'Delete an API key from a sub-account (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_sub_account_delete_sub_account_key', 'Delete an API key from a sub-account (requires authentication) — always confirm with the user before calling this tool', {
         user_id: z.number().int().describe('Sub-account user ID'),
         key: z.string().describe('API key to delete'),
     }, async ({ user_id, key }) => {

package/dist/tools/unified.js

@@ -3,7 +3,7 @@ import { UnifiedApi } from 'gate-api';
 import { createClient, requireAuth } from '../client.js';
 import { textContent, errorContent } from '../utils.js';
 export function registerUnifiedTools(server) {
-    server.tool('cex.unified.get_unified_accounts', 'Get unified account balances and info (requires authentication)', {
+    server.tool('cex_unified_get_unified_accounts', 'Get unified account balances and info (requires authentication)', {
         currency: z.string().optional().describe('Filter by currency'),
         sub_uid: z.string().optional().describe('Sub-account UID'),
     }, async ({ currency, sub_uid }) => {
@@ -21,7 +21,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.list_unified_currencies', 'List currencies supported in unified account (requires authentication)', { currency: z.string().optional().describe('Filter by currency') }, async ({ currency }) => {
+    server.tool('cex_unified_list_unified_currencies', 'List currencies supported in unified account (requires authentication)', { currency: z.string().optional().describe('Filter by currency') }, async ({ currency }) => {
         try {
             requireAuth();
             const opts = {};
@@ -34,7 +34,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.get_unified_mode', 'Get current unified account mode (requires authentication)', {}, async () => {
+    server.tool('cex_unified_get_unified_mode', 'Get current unified account mode (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new UnifiedApi(createClient()).getUnifiedMode();
@@ -44,7 +44,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.set_unified_mode', 'Switch unified account mode (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_unified_set_unified_mode', 'Switch unified account mode (requires authentication) — always confirm with the user before calling this tool', {
         mode: z.string().describe('Mode: classic, multi_currency, or portfolio'),
     }, async ({ mode }) => {
         try {
@@ -56,7 +56,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.get_unified_risk_units', 'Get risk unit details for portfolio margin mode (requires authentication)', {}, async () => {
+    server.tool('cex_unified_get_unified_risk_units', 'Get risk unit details for portfolio margin mode (requires authentication)', {}, async () => {
         try {
             requireAuth();
             const { body } = await new UnifiedApi(createClient()).getUnifiedRiskUnits();
@@ -66,7 +66,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.get_unified_borrowable', 'Get maximum borrowable amount for a currency in unified account (requires authentication)', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
+    server.tool('cex_unified_get_unified_borrowable', 'Get maximum borrowable amount for a currency in unified account (requires authentication)', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
         try {
             requireAuth();
             const { body } = await new UnifiedApi(createClient()).getUnifiedBorrowable(currency);
@@ -76,7 +76,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.get_unified_transferable', 'Get maximum transferable amount for a currency in unified account (requires authentication)', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
+    server.tool('cex_unified_get_unified_transferable', 'Get maximum transferable amount for a currency in unified account (requires authentication)', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
         try {
             requireAuth();
             const { body } = await new UnifiedApi(createClient()).getUnifiedTransferable(currency);
@@ -86,7 +86,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.get_unified_estimate_rate', 'Get estimated borrow interest rates for currencies (requires authentication)', { currencies: z.array(z.string()).describe('List of currency symbols e.g. ["BTC","USDT"]') }, async ({ currencies }) => {
+    server.tool('cex_unified_get_unified_estimate_rate', 'Get estimated borrow interest rates for currencies (requires authentication)', { currencies: z.array(z.string()).describe('List of currency symbols e.g. ["BTC","USDT"]') }, async ({ currencies }) => {
         try {
             requireAuth();
             const { body } = await new UnifiedApi(createClient()).getUnifiedEstimateRate(currencies);
@@ -96,7 +96,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.list_unified_loans', 'List active loans in unified account (requires authentication)', {
+    server.tool('cex_unified_list_unified_loans', 'List active loans in unified account (requires authentication)', {
         currency: z.string().optional().describe('Filter by currency'),
         type: z.string().optional().describe('Loan type: platform or margin'),
         page: z.number().int().min(1).optional(),
@@ -120,7 +120,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.create_unified_loan', 'Borrow or repay in unified account (requires authentication) — always confirm the details with the user before calling this tool', {
+    server.tool('cex_unified_create_unified_loan', 'Borrow or repay in unified account (requires authentication) — always confirm the details with the user before calling this tool', {
         currency: z.string().describe('Currency to borrow/repay'),
         type: z.enum(['borrow', 'repay']),
         amount: z.string().describe('Amount to borrow or repay'),
@@ -141,7 +141,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.list_unified_loan_records', 'Get borrow/repay history in unified account (requires authentication)', {
+    server.tool('cex_unified_list_unified_loan_records', 'Get borrow/repay history in unified account (requires authentication)', {
         currency: z.string().optional(),
         type: z.string().optional().describe('borrow or repay'),
         page: z.number().int().min(1).optional(),
@@ -165,7 +165,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.list_unified_loan_interest_records', 'Get interest charge history in unified account (requires authentication)', {
+    server.tool('cex_unified_list_unified_loan_interest_records', 'Get interest charge history in unified account (requires authentication)', {
         currency: z.string().optional(),
         type: z.string().optional().describe('Loan type'),
         from: z.number().optional().describe('Start time (Unix timestamp)'),
@@ -195,7 +195,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.list_currency_discount_tiers', 'List currency discount tiers for unified account collateral', {}, async () => {
+    server.tool('cex_unified_list_currency_discount_tiers', 'List currency discount tiers for unified account collateral', {}, async () => {
         try {
             const { body } = await new UnifiedApi(createClient()).listCurrencyDiscountTiers();
             return textContent(body);
@@ -204,7 +204,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.get_user_leverage_currency_setting', 'Get leverage settings for currencies in unified account (requires authentication)', { currency: z.string().optional().describe('Filter by currency') }, async ({ currency }) => {
+    server.tool('cex_unified_get_user_leverage_currency_setting', 'Get leverage settings for currencies in unified account (requires authentication)', { currency: z.string().optional().describe('Filter by currency') }, async ({ currency }) => {
         try {
             requireAuth();
             const opts = {};
@@ -217,7 +217,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.set_user_leverage_currency_setting', 'Set leverage for a currency in unified account (requires authentication) — always confirm with the user before calling this tool', {
+    server.tool('cex_unified_set_user_leverage_currency_setting', 'Set leverage for a currency in unified account (requires authentication) — always confirm with the user before calling this tool', {
         currency: z.string().describe('Currency symbol e.g. BTC'),
         leverage: z.string().describe('Leverage value'),
     }, async ({ currency, leverage }) => {
@@ -230,7 +230,7 @@ export function registerUnifiedTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.unified.set_unified_collateral', 'Enable or disable currencies as collateral in unified account (requires authentication)', {
+    server.tool('cex_unified_set_unified_collateral', 'Enable or disable currencies as collateral in unified account (requires authentication)', {
         enable_list: z.array(z.string()).optional().describe('Currencies to enable as collateral'),
         disable_list: z.array(z.string()).optional().describe('Currencies to disable as collateral'),
     }, async ({ enable_list, disable_list }) => {

package/dist/tools/wallet.js

@@ -3,7 +3,7 @@ import { WalletApi, SubAccountTransfer, SubAccountToSubAccount } from 'gate-api'
 import { createClient, requireAuth } from '../client.js';
 import { textContent, errorContent } from '../utils.js';
 export function registerWalletTools(server) {
-    server.tool('cex.wallet.get_total_balance', 'Get total account balance across all wallets (requires authentication)', {
+    server.tool('cex_wallet_get_total_balance', 'Get total account balance across all wallets (requires authentication)', {
         currency: z.string().optional().describe('Quote currency for conversion (default: USDT)'),
     }, async ({ currency }) => {
         try {
@@ -18,7 +18,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.list_withdrawals', 'List withdrawal history (requires authentication)', {
+    server.tool('cex_wallet_list_withdrawals', 'List withdrawal history (requires authentication)', {
         currency: z.string().optional().describe('Filter by currency'),
         limit: z.number().int().optional(),
         offset: z.number().int().optional(),
@@ -39,7 +39,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.list_deposits', 'List deposit history (requires authentication)', {
+    server.tool('cex_wallet_list_deposits', 'List deposit history (requires authentication)', {
         currency: z.string().optional().describe('Filter by currency'),
         limit: z.number().int().optional(),
         offset: z.number().int().optional(),
@@ -60,7 +60,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.get_deposit_address', 'Get deposit address for a currency (requires authentication)', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
+    server.tool('cex_wallet_get_deposit_address', 'Get deposit address for a currency (requires authentication)', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
         try {
             requireAuth();
             const { body } = await new WalletApi(createClient()).getDepositAddress(currency);
@@ -70,7 +70,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.create_transfer', 'Transfer funds between accounts (requires authentication) — always confirm the amount, source, and destination with the user before calling this tool', {
+    server.tool('cex_wallet_create_transfer', 'Transfer funds between accounts (requires authentication) — always confirm the amount, source, and destination with the user before calling this tool', {
         currency: z.string().describe('Currency to transfer'),
         from: z.enum(['spot', 'margin', 'futures', 'delivery', 'options']).describe('Source account'),
         to: z.enum(['spot', 'margin', 'futures', 'delivery', 'options']).describe('Destination account'),
@@ -92,7 +92,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.list_sub_account_balances', 'List sub-account balances (requires authentication)', { sub_uid: z.string().optional().describe('Filter by sub-account UID') }, async ({ sub_uid }) => {
+    server.tool('cex_wallet_list_sub_account_balances', 'List sub-account balances (requires authentication)', { sub_uid: z.string().optional().describe('Filter by sub-account UID') }, async ({ sub_uid }) => {
         try {
             requireAuth();
             const opts = {};
@@ -105,7 +105,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.get_wallet_fee', 'Get trading fee rates (requires authentication)', {
+    server.tool('cex_wallet_get_wallet_fee', 'Get trading fee rates (requires authentication)', {
         currency_pair: z.string().optional().describe('Filter by currency pair'),
         settle: z.enum(['BTC', 'USDT', 'USD']).optional().describe('Futures settlement currency'),
     }, async ({ currency_pair, settle }) => {
@@ -123,7 +123,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.create_sub_account_transfer', 'Transfer between main account and sub-account (requires authentication) — always confirm the amount with the user before calling this tool', {
+    server.tool('cex_wallet_create_sub_account_transfer', 'Transfer between main account and sub-account (requires authentication) — always confirm the amount with the user before calling this tool', {
         sub_account: z.string().describe('Sub-account user ID'),
         currency: z.string().describe('Currency name e.g. USDT'),
         amount: z.string().describe('Transfer amount'),
@@ -149,7 +149,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.create_sub_account_to_sub_account_transfer', 'Transfer between two sub-accounts under the same main account (requires authentication) — always confirm the amount with the user before calling this tool', {
+    server.tool('cex_wallet_create_sub_account_to_sub_account_transfer', 'Transfer between two sub-accounts under the same main account (requires authentication) — always confirm the amount with the user before calling this tool', {
         currency: z.string().describe('Currency name e.g. USDT'),
         sub_account_from: z.string().describe('Source sub-account user ID'),
         sub_account_from_type: z.string().describe('Source sub-account type: spot/futures/delivery'),
@@ -173,7 +173,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.get_transfer_order_status', 'Query main-sub account transfer status (requires authentication)', {
+    server.tool('cex_wallet_get_transfer_order_status', 'Query main-sub account transfer status (requires authentication)', {
         client_order_id: z.string().optional().describe('Client specified custom ID'),
         tx_id: z.string().optional().describe('Transaction ID returned by the transfer API'),
     }, async ({ client_order_id, tx_id }) => {
@@ -191,7 +191,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.list_currency_chains', 'List chains supported for a currency', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
+    server.tool('cex_wallet_list_currency_chains', 'List chains supported for a currency', { currency: z.string().describe('Currency symbol e.g. USDT') }, async ({ currency }) => {
         try {
             const { body } = await new WalletApi(createClient()).listCurrencyChains(currency);
             return textContent(body);
@@ -200,7 +200,7 @@ export function registerWalletTools(server) {
             return errorContent(e);
         }
     });
-    server.tool('cex.wallet.list_withdraw_status', 'Get withdrawal status for all currencies (requires authentication)', { currency: z.string().optional().describe('Filter by currency') }, async ({ currency }) => {
+    server.tool('cex_wallet_list_withdraw_status', 'Get withdrawal status for all currencies (requires authentication)', { currency: z.string().optional().describe('Filter by currency') }, async ({ currency }) => {
         try {
             requireAuth();
             const opts = {};

package/dist/utils.d.ts

@@ -32,4 +32,10 @@ export declare function errorContent(err: unknown): {
     }[];
     isError: boolean;
 };
+/**
+ * Returns true if the tool name refers to a state-mutating (write) operation.
+ * Tool names follow the pattern cex_{module}_{verb}_{rest}, so the verb is always
+ * the third underscore-separated segment (index 2).
+ */
+export declare function isWriteTool(name: string): boolean;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO;;;;;EAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO;;;;;;EAGxC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO;;;;;EAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO;;;;;;EAGxC;AAOD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/utils.js

@@ -36,4 +36,16 @@ export function errorContent(err) {
     const message = err instanceof Error ? err.message : String(err);
     return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
 }
+const WRITE_VERBS = new Set([
+    'create', 'cancel', 'amend', 'update', 'set',
+    'delete', 'lock', 'unlock', 'add', 'countdown',
+]);
+/**
+ * Returns true if the tool name refers to a state-mutating (write) operation.
+ * Tool names follow the pattern cex_{module}_{verb}_{rest}, so the verb is always
+ * the third underscore-separated segment (index 2).
+ */
+export function isWriteTool(name) {
+    return WRITE_VERBS.has(name.split('_')[2] ?? '');
+}
 //# sourceMappingURL=utils.js.map