Gate DEX MCP

Official47 tools

by gate · Shell

Gate DEX MCP for wallet auth, transfers, swaps, token info, market data, and RPC access.

io.github.gateio-dev/gate-dex MCP Server

The io.github.gateio-dev/gate-dex Model Context Protocol (MCP) server provides AI agents access to the Gate cryptocurrency exchange. It supports wallet authentication and account management alongside public market data, token information, transfers, swaps, trading, and RPC access. The repository is MIT licensed and includes an English and Chinese README.

🛠️ Key Features

Wallet auth
Transfers and swaps
Token info
Market data
RPC access
Public market data and derivatives coverage (spot, futures, margin, options, delivery, earn, alpha tickers, order books, K-line, funding rate, liquidation history)

🚀 Use Cases

Trading and account management via an agent
Fetching token and market data for decision-making
Performing wallet-based transfers and swaps

⚡ Developer Benefits

47 tools exposed via MCP
Direct integration with Gate exchange capabilities through MCP

⚠️ Limitations

Features list is described at a high level; the excerpt shown cuts off before complete details.

Captured live from the server via tools/list.

dex_agentic_report

Parameters2

mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
wallets	object	required	Array of wallet info objects. Each wallet contains walletID and accounts array. Each account contains accountID and chainAddressList array. Each chainAddress contains networkKey, chains, chainAddress, and optional accountKey/accountFormat.

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "wallets": {
      "description": "Array of wallet info objects. Each wallet contains walletID and accounts array. Each account contains accountID and chainAddressList array. Each chainAddress contains networkKey, chains, chainAddress, and optional accountKey/accountFormat.",
      "properties": {},
      "type": "object"
    }
  },
  "required": [
    "wallets"
  ]
}

dex_auth_gate_login_poll

Poll Gate OAuth; returns pending/ok/error. [write] On ok: replace mcp_token unless linked_to_google_session is true. Pass auto_replace_binding=true to rebind exchange UID on new Gate session.

Parameters2

auto_replace_binding	boolean	optional	If true and status is ok: when new session walletType is not gate_mcp/gate_quick, call BW POST /v1/wallet/inner/rebind (same as dex_wallet_replace_binding). Gate-native sessions are blocked without calling BW.
flow_id	string	required	Flow ID returned by dex_auth_gate_login_start

Raw schema

{
  "type": "object",
  "properties": {
    "auto_replace_binding": {
      "description": "If true and status is ok: when new session walletType is not gate_mcp/gate_quick, call BW POST /v1/wallet/inner/rebind (same as dex_wallet_replace_binding). Gate-native sessions are blocked without calling BW.",
      "type": "boolean"
    },
    "flow_id": {
      "description": "Flow ID returned by dex_auth_gate_login_start",
      "type": "string"
    }
  },
  "required": [
    "flow_id"
  ]
}

dex_auth_gate_login_start

Start Gate device OAuth; returns verification_url. Pass link_mcp_token on a Google session to bind Gate UID without replacing mcp_token.

Parameters1

link_mcp_token

string

optional

Current Google wallet mcp_token for bind-only Gate OAuth; omit for standalone Gate login

Raw schema

{
  "type": "object",
  "properties": {
    "link_mcp_token": {
      "description": "Current Google wallet mcp_token for bind-only Gate OAuth; omit for standalone Gate login",
      "type": "string"
    }
  },
  "required": []
}

dex_auth_google_login_poll

Poll Google OAuth flow; returns pending/ok/error. [write] On ok: immediately replace stored mcp_token with login_result.mcp_token — new token is tied to a different account.

Parameters1

flow_id

string

required

Flow ID returned by dex_auth_google_login_start

Raw schema

{
  "type": "object",
  "properties": {
    "flow_id": {
      "description": "Flow ID returned by dex_auth_google_login_start",
      "type": "string"
    }
  },
  "required": [
    "flow_id"
  ]
}

dex_auth_google_login_start

Returns browser verification URL for Google device OAuth.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

dex_auth_login_gate_wallet

Exchange Gate OAuth code for MCP token. [write] On success, immediately replace any stored mcp_token — new token is tied to a different account.

Parameters2

code	string	required	Gate OAuth authorization code
redirect_url	string	required	Gate OAuth redirect URL used in the authorization request

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "description": "Gate OAuth authorization code",
      "type": "string"
    },
    "redirect_url": {
      "description": "Gate OAuth redirect URL used in the authorization request",
      "type": "string"
    }
  },
  "required": [
    "code",
    "redirect_url"
  ]
}

dex_auth_login_google_wallet

Exchange Google OAuth code for MCP token. [write] On success, immediately replace any stored mcp_token — new token is tied to a different account.

Parameters2

code	string	required	Google OAuth authorization code
redirect_url	string	required	Google OAuth redirect URL used in the authorization request

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "description": "Google OAuth authorization code",
      "type": "string"
    },
    "redirect_url": {
      "description": "Google OAuth redirect URL used in the authorization request",
      "type": "string"
    }
  },
  "required": [
    "code",
    "redirect_url"
  ]
}

dex_auth_logout

Revoke the MCP session identified by mcp_token.

Parameters1

mcp_token

string

required

MCP session token to revoke

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token to revoke",
      "type": "string"
    }
  },
  "required": [
    "mcp_token"
  ]
}

dex_chain_config

Returns chain config (networkKey, accountKey, chainID). Use the returned chain value in all subsequent transfer/sign/broadcast tools.

Parameters2

chain	string	required	Chain name or alias (matching is case-insensitive). Use the returned `chain` value for all subsequent tools on that network.
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name or alias (matching is case-insensitive). Use the returned `chain` value for all subsequent tools on that network.",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": [
    "chain"
  ]
}

dex_market_get_kline

OHLCV candles by period and window. Volume aggregates→get_tx_stats. Pool events→get_pair_liquidity.

Parameters7

chain	string	required	Chain name. Supported: bsc, base, eth, solana, arbitrum, polygon, avalanche, fantom, zksync, linea, optimism, sui, blast, tron, merlin, world, eni, bera, gatelayer, ton
end_time	string	optional	End time (unix seconds); default: now
limit	string	optional	Max number of candles (default 100, max 1000)
pair_address	string	optional	Optional pair address
period	string	required	K-line period: seconds (e.g. 300, 3600) or 1m, 5m, 1h, 4h, 1d
start_time	string	optional	Start time (unix seconds); default: 100 periods before end_time
token_address	string	required	Token contract address

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name. Supported: bsc, base, eth, solana, arbitrum, polygon, avalanche, fantom, zksync, linea, optimism, sui, blast, tron, merlin, world, eni, bera, gatelayer, ton",
      "type": "string"
    },
    "end_time": {
      "description": "End time (unix seconds); default: now",
      "type": "string"
    },
    "limit": {
      "description": "Max number of candles (default 100, max 1000)",
      "type": "string"
    },
    "pair_address": {
      "description": "Optional pair address",
      "type": "string"
    },
    "period": {
      "description": "K-line period: seconds (e.g. 300, 3600) or 1m, 5m, 1h, 4h, 1d",
      "type": "string"
    },
    "start_time": {
      "description": "Start time (unix seconds); default: 100 periods before end_time",
      "type": "string"
    },
    "token_address": {
      "description": "Token contract address",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "token_address",
    "period"
  ]
}

dex_market_get_pair_liquidity

AMM pool deposit and withdrawal events. Candlesticks→get_kline. Volume stats→get_tx_stats.

Parameters5

chain	string	required	Chain name. Supported: bsc, base, eth, solana, arbitrum, polygon, avalanche, fantom, zksync, linea, optimism, sui, blast, tron, merlin, world, eni, bera, gatelayer, ton
page_index	string	optional	Page index (default 1)
page_size	string	optional	Page size (default 15, max 15)
pair_address	string	optional	Optional pair address
token_address	string	required	Token contract address

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name. Supported: bsc, base, eth, solana, arbitrum, polygon, avalanche, fantom, zksync, linea, optimism, sui, blast, tron, merlin, world, eni, bera, gatelayer, ton",
      "type": "string"
    },
    "page_index": {
      "description": "Page index (default 1)",
      "type": "string"
    },
    "page_size": {
      "description": "Page size (default 15, max 15)",
      "type": "string"
    },
    "pair_address": {
      "description": "Optional pair address",
      "type": "string"
    },
    "token_address": {
      "description": "Token contract address",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "token_address"
  ]
}

dex_market_get_tx_stats

Per-interval buy/sell volume and tx counts (5m–24h). Candlesticks→get_kline. Pool events→get_pair_liquidity.

Parameters3

chain	string	required	Chain name. Supported: bsc, base, eth, solana, arbitrum, polygon, avalanche, fantom, zksync, linea, optimism, sui, blast, tron, merlin, world, eni, bera, gatelayer, ton
pair_address	string	optional	Optional pair address
token_address	string	required	Token contract address

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name. Supported: bsc, base, eth, solana, arbitrum, polygon, avalanche, fantom, zksync, linea, optimism, sui, blast, tron, merlin, world, eni, bera, gatelayer, ton",
      "type": "string"
    },
    "pair_address": {
      "description": "Optional pair address",
      "type": "string"
    },
    "token_address": {
      "description": "Token contract address",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "token_address"
  ]
}

dex_rpc_call

Proxy a JSON-RPC call to a blockchain node.

Parameters4

chain	string	required	Chain name (e.g., ETH, BSC, SOL, ARB, POLYGON)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
method	string	required	RPC method name (e.g., eth_blockNumber, eth_getBalance, getLatestBlockhash)
params	array	optional	RPC method parameters as JSON array

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name (e.g., ETH, BSC, SOL, ARB, POLYGON)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "method": {
      "description": "RPC method name (e.g., eth_blockNumber, eth_getBalance, getLatestBlockhash)",
      "type": "string"
    },
    "params": {
      "description": "RPC method parameters as JSON array",
      "type": "array"
    }
  },
  "required": [
    "chain",
    "method"
  ]
}

dex_token_get_coin_info

Price, market snapshot, metadata, optional top holders. Security audit→get_risk_info.

Parameters3

address	string	required	Token contract address
chain	string	required	Blockchain network
include_holders	string	optional	Include top holders (true/false, default true)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Token contract address",
      "type": "string"
    },
    "chain": {
      "description": "Blockchain network",
      "type": "string"
    },
    "include_holders": {
      "description": "Include top holders (true/false, default true)",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "address"
  ]
}

dex_token_get_coins_range_by_created_at

Tokens launched within a given time window; chain optional for all networks.

Parameters4

chain	string	optional	Optional chain filter; omit for all chains
end	string	required	End of creation time range (RFC3339, e.g. 2025-01-02T00:00:00Z)
limit	string	optional	Max number of tokens (1-100, default 20)
start	string	required	Start of creation time range (RFC3339, e.g. 2025-01-01T00:00:00Z)

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Optional chain filter; omit for all chains",
      "type": "string"
    },
    "end": {
      "description": "End of creation time range (RFC3339, e.g. 2025-01-02T00:00:00Z)",
      "type": "string"
    },
    "limit": {
      "description": "Max number of tokens (1-100, default 20)",
      "type": "string"
    },
    "start": {
      "description": "Start of creation time range (RFC3339, e.g. 2025-01-01T00:00:00Z)",
      "type": "string"
    }
  },
  "required": [
    "start",
    "end"
  ]
}

dex_token_get_risk_info

Contract security audit (honeypot, tax, ownership flags). Price and market stats→get_coin_info.

Parameters4

address	string	required	Token contract address
chain	string	required	Chain name. Supported: bsc, polygon, avalanche, arbitrum, optimism, base, fantom, linea, zksync, world, gatelayer, merlin, blast, eni, bera, solana, ton, sui, tron
ignore	string	optional	Set to true to hide empty risk items
lan	string	optional	Language code (e.g. en, zh)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Token contract address",
      "type": "string"
    },
    "chain": {
      "description": "Chain name. Supported: bsc, polygon, avalanche, arbitrum, optimism, base, fantom, linea, zksync, world, gatelayer, merlin, blast, eni, bera, solana, ton, sui, tron",
      "type": "string"
    },
    "ignore": {
      "description": "Set to true to hide empty risk items",
      "type": "string"
    },
    "lan": {
      "description": "Language code (e.g. en, zh)",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "address"
  ]
}

dex_token_list_cross_chain_bridge_tokens

Receivable assets on target chain for a source token. Same-chain trading→list_swap_tokens.

Parameters7

account_id	string	optional	User account ID. Only used when wallet is empty, to look up wallet addresses.
chain	string	required	Target chain identifier, e.g. bsc, arbitrum, polygon
search	string	optional	Search keyword (token symbol or contract address) to filter results
search_auth	boolean	optional	When searching, only return certified tokens. Only effective when search is non-empty.
source_address	string	required	Source token contract address on the source chain
source_chain	string	required	Source chain identifier, e.g. eth, bsc, solana
wallet	string	optional	User wallet address(es), comma-separated. Used to show balances and favorites.

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "User account ID. Only used when wallet is empty, to look up wallet addresses.",
      "type": "string"
    },
    "chain": {
      "description": "Target chain identifier, e.g. bsc, arbitrum, polygon",
      "type": "string"
    },
    "search": {
      "description": "Search keyword (token symbol or contract address) to filter results",
      "type": "string"
    },
    "search_auth": {
      "description": "When searching, only return certified tokens. Only effective when search is non-empty.",
      "type": "boolean"
    },
    "source_address": {
      "description": "Source token contract address on the source chain",
      "type": "string"
    },
    "source_chain": {
      "description": "Source chain identifier, e.g. eth, bsc, solana",
      "type": "string"
    },
    "wallet": {
      "description": "User wallet address(es), comma-separated. Used to show balances and favorites.",
      "type": "string"
    }
  },
  "required": [
    "source_chain",
    "source_address",
    "chain"
  ]
}

dex_token_list_swap_tokens

Tradable assets on a chain; tag selects favorites or recommendations. Bridge targets→list_cross_chain_bridge_tokens.

Parameters8

account_id	string	optional	User account ID. Only used when wallet is empty.
chain	string	optional	Chain identifier, e.g. eth, bsc, solana, arbitrum. Omit to query all chains.
ignore_bridge	boolean	optional	Ignore cross-chain bridge restrictions, only filter by chain. Default false.
search	string	optional	Search keyword (token symbol or contract address)
search_auth	boolean	optional	When searching, only return certified tokens. Only effective when search is non-empty.
tag	string	optional	List type: empty for normal token list; 'favorite' for user favorites (requires wallet/account_id); 'recommend' for system recommended tokens.
wallet	string	optional	User wallet address(es), comma-separated. Used for favorites and balance display.
web3_key	string	optional	Chain web3_key identifier. Only used when chain is empty, auto-maps to chain.

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "User account ID. Only used when wallet is empty.",
      "type": "string"
    },
    "chain": {
      "description": "Chain identifier, e.g. eth, bsc, solana, arbitrum. Omit to query all chains.",
      "type": "string"
    },
    "ignore_bridge": {
      "description": "Ignore cross-chain bridge restrictions, only filter by chain. Default false.",
      "type": "boolean"
    },
    "search": {
      "description": "Search keyword (token symbol or contract address)",
      "type": "string"
    },
    "search_auth": {
      "description": "When searching, only return certified tokens. Only effective when search is non-empty.",
      "type": "boolean"
    },
    "tag": {
      "description": "List type: empty for normal token list; 'favorite' for user favorites (requires wallet/account_id); 'recommend' for system recommended tokens.",
      "enum": [
        "",
        "favorite",
        "recommend"
      ],
      "type": "string"
    },
    "wallet": {
      "description": "User wallet address(es), comma-separated. Used for favorites and balance display.",
      "type": "string"
    },
    "web3_key": {
      "description": "Chain web3_key identifier. Only used when chain is empty, auto-maps to chain.",
      "type": "string"
    }
  },
  "required": []
}

dex_token_ranking

Top movers by 24h price change; direction selects gainers vs losers. Single token→get_coin_info.

Parameters3

chain	string	optional	Optional chain filter
direction	string	required	'desc' for top gainers, 'asc' for top losers
top_n	string	optional	Number of tokens (1-100, default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Optional chain filter",
      "type": "string"
    },
    "direction": {
      "description": "'desc' for top gainers, 'asc' for top losers",
      "type": "string"
    },
    "top_n": {
      "description": "Number of tokens (1-100, default 10)",
      "type": "string"
    }
  },
  "required": [
    "direction"
  ]
}

dex_tx_approve_preview

Build ERC20/SPL approve or revoke tx (does not broadcast). Sign with dex_wallet_sign_transaction after user confirmation.

Parameters13

action	string	optional	Action type: 'approve' (default) or 'revoke' (revoke all approvals, Solana only)
amount	string	required	Approval amount (human-readable). Set to '0' to revoke approval (EVM), set to 'unlimited' or 'max' for maximum allowance
chain	string	optional	Chain name (default ETH). Based on backend chain configuration.
max_fee_per_gas	string	optional	EVM: override max fee per gas (wei)
max_priority_fee_per_gas	string	optional	EVM: override max priority fee per gas (wei)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
nonce	string	optional	EVM: transaction nonce. Omit to auto-fetch current nonce.
owner	string	required	Owner address (your wallet address)
priority_fee_micro_lamports	string	optional	Solana: priority fee (micro-lamports per compute unit)
spender	string	required	Spender address (EVM: spender contract address; Solana: delegate account address)
token_contract	string	optional	EVM: ERC20 contract address (required for EVM)
token_decimals	string	required	Token decimals (e.g. 6, 18, 9)
token_mint	string	optional	Solana: SPL Token mint address (required for Solana)

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "description": "Action type: 'approve' (default) or 'revoke' (revoke all approvals, Solana only)",
      "type": "string"
    },
    "amount": {
      "description": "Approval amount (human-readable). Set to '0' to revoke approval (EVM), set to 'unlimited' or 'max' for maximum allowance",
      "type": "string"
    },
    "chain": {
      "description": "Chain name (default ETH). Based on backend chain configuration.",
      "type": "string"
    },
    "max_fee_per_gas": {
      "description": "EVM: override max fee per gas (wei)",
      "type": "string"
    },
    "max_priority_fee_per_gas": {
      "description": "EVM: override max priority fee per gas (wei)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "nonce": {
      "description": "EVM: transaction nonce. Omit to auto-fetch current nonce.",
      "type": "string"
    },
    "owner": {
      "description": "Owner address (your wallet address)",
      "type": "string"
    },
    "priority_fee_micro_lamports": {
      "description": "Solana: priority fee (micro-lamports per compute unit)",
      "type": "string"
    },
    "spender": {
      "description": "Spender address (EVM: spender contract address; Solana: delegate account address)",
      "type": "string"
    },
    "token_contract": {
      "description": "EVM: ERC20 contract address (required for EVM)",
      "type": "string"
    },
    "token_decimals": {
      "description": "Token decimals (e.g. 6, 18, 9)",
      "type": "string"
    },
    "token_mint": {
      "description": "Solana: SPL Token mint address (required for Solana)",
      "type": "string"
    }
  },
  "required": [
    "owner",
    "spender",
    "amount",
    "token_decimals"
  ]
}

dex_tx_detail

Fetch transaction detail by on-chain hash. → swap_detail for swap order detail by order ID.

Parameters3

from_wallet	string	optional	Optional sender wallet address filter
hash_id	string	required	Transaction hash ID
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "from_wallet": {
      "description": "Optional sender wallet address filter",
      "type": "string"
    },
    "hash_id": {
      "description": "Transaction hash ID",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": [
    "hash_id"
  ]
}

dex_tx_gas

Estimate on-chain gas price and gas limit for a given tx.

Parameters7

chain	string	required	Chain name or alias; resolved via dex_chain_config before calling upstream.
data	string	optional	Transaction calldata (hex)
from	string	required	Sender address
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
network	string	optional	Network name
to	string	required	Recipient address
value	string	optional	Transfer value in wei

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name or alias; resolved via dex_chain_config before calling upstream.",
      "type": "string"
    },
    "data": {
      "description": "Transaction calldata (hex)",
      "type": "string"
    },
    "from": {
      "description": "Sender address",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "network": {
      "description": "Network name",
      "type": "string"
    },
    "to": {
      "description": "Recipient address",
      "type": "string"
    },
    "value": {
      "description": "Transfer value in wei",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "from",
    "to"
  ]
}

dex_tx_get_sol_unsigned

Solana only: build fresh native SOL unsigned tx with latest blockhash; avoids Blockhash not found. Sign immediately. → transfer_preview for full summary first.

Parameters5

amount	string	required	Amount in SOL, e.g. 0.0001
from	string	required	Sender address (base58)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
priority_fee_micro_lamports	string	optional	Optional priority fee (micro-lamports per compute unit). Try 1000-10000 if broadcast returns replacement transaction underpriced.
to	string	required	Recipient address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Amount in SOL, e.g. 0.0001",
      "type": "string"
    },
    "from": {
      "description": "Sender address (base58)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "priority_fee_micro_lamports": {
      "description": "Optional priority fee (micro-lamports per compute unit). Try 1000-10000 if broadcast returns replacement transaction underpriced.",
      "type": "string"
    },
    "to": {
      "description": "Recipient address (base58)",
      "type": "string"
    }
  },
  "required": [
    "from",
    "to",
    "amount"
  ]
}

dex_tx_list

List wallet transaction history (transfers). → swap_history_list for swap/bridge orders. → tx_detail for single tx by hash.

Parameters8

account_id	string	required	Account ID
address	string	optional	Wallet address filter
cursor	string	optional	Pagination cursor
end_time	string	optional	End time (Unix seconds or ISO8601)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
page_num	string	optional	Page number (1-based)
page_size	string	optional	Page size (default 20)
start_time	string	optional	Start time (Unix seconds or ISO8601)

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID",
      "type": "string"
    },
    "address": {
      "description": "Wallet address filter",
      "type": "string"
    },
    "cursor": {
      "description": "Pagination cursor",
      "type": "string"
    },
    "end_time": {
      "description": "End time (Unix seconds or ISO8601)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "page_num": {
      "description": "Page number (1-based)",
      "type": "string"
    },
    "page_size": {
      "description": "Page size (default 20)",
      "type": "string"
    },
    "start_time": {
      "description": "Start time (Unix seconds or ISO8601)",
      "type": "string"
    }
  },
  "required": [
    "account_id"
  ]
}

dex_tx_send_raw_transaction

Broadcast a signed tx to the chain. [write] Requires user confirmation after transfer preview and prior signing via dex_wallet_sign_transaction.

Parameters20

account_id	string	optional	Account ID (for history_data)
action_type	string	optional	Action type (history_data.action_type)
address	string	optional	Sender wallet address (history_data.address)
chain	string	required	Chain name: must match dex_chain_config response `chain` (canonical). Aliases are resolved via chain config before calling upstream.
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
memo	string	optional	Memo (history_data.memo)
network	string	optional	Network name
nonce	number	optional	Nonce (history_data.nonce)
signed_tx	string	required	Signed transaction data. For EVM chains: hex string (0x prefix added automatically). For other chains (e.g. Solana): use chain-specific format
token_addr	string	optional	Token contract address (history_data.token_addr)
token_name	string	optional	Token name (history_data.token_name)
token_short_name	string	optional	Token symbol, e.g. USDT (history_data.token_short_name)
trans_balance	string	optional	Display amount (history_data.trans_balance)
trans_balance_usd	string	optional	USD value (history_data.trans_balance_usd)
trans_gas_fee	string	optional	Gas fee display (history_data.trans_gas_fee)
trans_min_unit_amount	string	optional	Amount in smallest unit (history_data.trans_min_unit_amount)
trans_min_unit_gas_fee	string	optional	Gas fee in smallest unit (history_data.trans_min_unit_gas_fee)
trans_oppo_address	string	optional	Counterparty address, e.g. recipient (history_data.trans_oppo_address)
trans_time	string	optional	Transaction time ISO8601 (default: now)
trans_type	string	optional	Transaction type (history_data.trans_type)

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID (for history_data)",
      "type": "string"
    },
    "action_type": {
      "description": "Action type (history_data.action_type)",
      "type": "string"
    },
    "address": {
      "description": "Sender wallet address (history_data.address)",
      "type": "string"
    },
    "chain": {
      "description": "Chain name: must match dex_chain_config response `chain` (canonical). Aliases are resolved via chain config before calling upstream.",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "memo": {
      "description": "Memo (history_data.memo)",
      "type": "string"
    },
    "network": {
      "description": "Network name",
      "type": "string"
    },
    "nonce": {
      "description": "Nonce (history_data.nonce)",
      "type": "number"
    },
    "signed_tx": {
      "description": "Signed transaction data. For EVM chains: hex string (0x prefix added automatically). For other chains (e.g. Solana): use chain-specific format",
      "type": "string"
    },
    "token_addr": {
      "description": "Token contract address (history_data.token_addr)",
      "type": "string"
    },
    "token_name": {
      "description": "Token name (history_data.token_name)",
      "type": "string"
    },
    "token_short_name": {
      "description": "Token symbol, e.g. USDT (history_data.token_short_name)",
      "type": "string"
    },
    "trans_balance": {
      "description": "Display amount (history_data.trans_balance)",
      "type": "string"
    },
    "trans_balance_usd": {
      "description": "USD value (history_data.trans_balance_usd)",
      "type": "string"
    },
    "trans_gas_fee": {
      "description": "Gas fee display (history_data.trans_gas_fee)",
      "type": "string"
    },
    "trans_min_unit_amount": {
      "description": "Amount in smallest unit (history_data.trans_min_unit_amount)",
      "type": "string"
    },
    "trans_min_unit_gas_fee": {
      "description": "Gas fee in smallest unit (history_data.trans_min_unit_gas_fee)",
      "type": "string"
    },
    "trans_oppo_address": {
      "description": "Counterparty address, e.g. recipient (history_data.trans_oppo_address)",
      "type": "string"
    },
    "trans_time": {
      "description": "Transaction time ISO8601 (default: now)",
      "type": "string"
    },
    "trans_type": {
      "description": "Transaction type (history_data.trans_type)",
      "type": "string"
    }
  },
  "required": [
    "chain",
    "signed_tx"
  ]
}

dex_tx_swap_checkin_preview

Returns check-in fields for a swap stage (approve or swap). Call after prepare and before terminal tx-checkin script.

Parameters3

mcp_token	string	required	MCP session token (required in the tool schema). After Google or Gate wallet login, read it from login_result when dex_auth_google_login_poll or dex_auth_gate_login_poll returns success. The server checks this argument first, then the HTTP Authorization header (Bearer mcp_pat_...) — often the same string configured as headers.Authorization on your MCP server in local MCP client config. If there is no token yet, run auth start + poll first. If expired, try dex_auth_refresh_token; if that fails, log in again.
stage	string	required	Preview stage: 'approve' or 'swap'
swap_session_id	string	required	Swap session ID returned by dex_tx_swap_prepare

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token (required in the tool schema). After Google or Gate wallet login, read it from login_result when dex_auth_google_login_poll or dex_auth_gate_login_poll returns success. The server checks this argument first, then the HTTP Authorization header (Bearer mcp_pat_...) — often the same string configured as headers.Authorization on your MCP server in local MCP client config. If there is no token yet, run auth start + poll first. If expired, try dex_auth_refresh_token; if that fails, log in again.",
      "type": "string"
    },
    "stage": {
      "description": "Preview stage: 'approve' or 'swap'",
      "type": "string"
    },
    "swap_session_id": {
      "description": "Swap session ID returned by dex_tx_swap_prepare",
      "type": "string"
    }
  },
  "required": [
    "swap_session_id",
    "stage",
    "mcp_token"
  ]
}

dex_tx_swap_detail

Fetch swap order detail by order ID from swap_submit. → tx_detail for detail by on-chain hash.

Parameters2

mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
tx_order_id	string	required	Transaction order ID from dex_tx_swap_submit

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "tx_order_id": {
      "description": "Transaction order ID from dex_tx_swap_submit",
      "type": "string"
    }
  },
  "required": [
    "tx_order_id"
  ]
}

dex_tx_swap_history_list

List swap/bridge order history with pagination; includes single-chain and cross-chain. → tx_list for transfer history.

Parameters8

account_id	string	required	Account ID (wallet address)
dst_chain	number	optional	Destination chain ID filter. 0 or omit for all chains
end_time	string	optional	End time filter (ISO8601 format)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
page_num	number	optional	Page number (0-based, default 0)
page_size	number	optional	Page size (default 20)
src_chain	number	optional	Source chain ID filter (e.g. 1=ETH, 56=BSC). 0 or omit for all chains
start_time	string	optional	Start time filter (ISO8601 format, e.g. 2025-01-01T00:00:00Z)

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID (wallet address)",
      "type": "string"
    },
    "dst_chain": {
      "description": "Destination chain ID filter. 0 or omit for all chains",
      "type": "number"
    },
    "end_time": {
      "description": "End time filter (ISO8601 format)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "page_num": {
      "description": "Page number (0-based, default 0)",
      "type": "number"
    },
    "page_size": {
      "description": "Page size (default 20)",
      "type": "number"
    },
    "src_chain": {
      "description": "Source chain ID filter (e.g. 1=ETH, 56=BSC). 0 or omit for all chains",
      "type": "number"
    },
    "start_time": {
      "description": "Start time filter (ISO8601 format, e.g. 2025-01-01T00:00:00Z)",
      "type": "string"
    }
  },
  "required": [
    "account_id"
  ]
}

dex_tx_swap_prepare

Stage a swap session (server-side build only); returns swap_session_id. Does not sign or submit. Call after quote confirmed by user.

Parameters12

account_id	string	required	User account ID (UUID)
amount	string	required	Human-readable amount (e.g. '0.01')
chain_id_in	number	required	Source chain ID (e.g. 1=ETH, 56=BSC, 501=Solana)
chain_id_out	number	required	Destination chain ID. Same as chain_id_in for single-chain swap
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
native_in	number	required	⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_in a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_in=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_in=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_in=1, token_in is auto-normalized to '-'.
native_out	number	required	⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_out a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_out=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_out=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_out=1, token_out is auto-normalized to '-'. CROSS-CHAIN EXAMPLE: USDT(BSC) → SOL(Solana): native_in=0 (USDT is contract token), native_out=1 (SOL is native coin). CROSS-CHAIN EXAMPLE: ETH(Ethereum) → USDT(BSC): native_in=1 (ETH is native coin), native_out=0 (USDT is contract token).
slippage	number	required	Slippage as decimal (0.01=1%, 0.1=10%)
to_wallet	string	optional	Destination chain receiving address. ONLY required for CROSS-CHAIN swaps where chain_id_in and chain_id_out belong to different address groups (e.g. EVM→Solana). Obtain from dex_wallet_get_addresses. Omit for single-chain swaps — defaults to user_wallet.
token_in	string	required	Source token address. Use '-' for native coin
token_out	string	required	Destination token address
user_wallet	string	required	User's wallet address matching the SOURCE CHAIN. MUST be chain-specific: call dex_wallet_get_addresses(account_id) to get addresses, use addresses["EVM"] for EVM chains or addresses["SOL"] for Solana (chain_id=501). NEVER use an EVM address (0x...) for Solana or a Solana address for EVM chains. For cross-chain swaps this is the FROM (source) chain address.

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "User account ID (UUID)",
      "type": "string"
    },
    "amount": {
      "description": "Human-readable amount (e.g. '0.01')",
      "type": "string"
    },
    "chain_id_in": {
      "description": "Source chain ID (e.g. 1=ETH, 56=BSC, 501=Solana)",
      "type": "number"
    },
    "chain_id_out": {
      "description": "Destination chain ID. Same as chain_id_in for single-chain swap",
      "type": "number"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "native_in": {
      "description": "⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_in a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_in=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_in=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_in=1, token_in is auto-normalized to '-'.",
      "type": "number"
    },
    "native_out": {
      "description": "⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_out a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_out=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_out=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_out=1, token_out is auto-normalized to '-'. CROSS-CHAIN EXAMPLE: USDT(BSC) → SOL(Solana): native_in=0 (USDT is contract token), native_out=1 (SOL is native coin). CROSS-CHAIN EXAMPLE: ETH(Ethereum) → USDT(BSC): native_in=1 (ETH is native coin), native_out=0 (USDT is contract token).",
      "type": "number"
    },
    "slippage": {
      "description": "Slippage as decimal (0.01=1%, 0.1=10%)",
      "type": "number"
    },
    "to_wallet": {
      "description": "Destination chain receiving address. ONLY required for CROSS-CHAIN swaps where chain_id_in and chain_id_out belong to different address groups (e.g. EVM→Solana). Obtain from dex_wallet_get_addresses. Omit for single-chain swaps — defaults to user_wallet.",
      "type": "string"
    },
    "token_in": {
      "description": "Source token address. Use '-' for native coin",
      "type": "string"
    },
    "token_out": {
      "description": "Destination token address",
      "type": "string"
    },
    "user_wallet": {
      "description": "User's wallet address matching the SOURCE CHAIN. MUST be chain-specific: call dex_wallet_get_addresses(account_id) to get addresses, use addresses[\"EVM\"] for EVM chains or addresses[\"SOL\"] for Solana (chain_id=501). NEVER use an EVM address (0x...) for Solana or a Solana address for EVM chains. For cross-chain swaps this is the FROM (source) chain address.",
      "type": "string"
    }
  },
  "required": [
    "chain_id_in",
    "chain_id_out",
    "token_in",
    "token_out",
    "amount",
    "slippage",
    "user_wallet",
    "native_in",
    "native_out",
    "account_id"
  ]
}

dex_tx_swap_quote

Returns swap route and pricing. Call before swap_prepare; show result to user before proceeding. → transfer_preview for direct token send (not exchange).

Parameters11

amount	string	required	Human-readable amount of source token to swap, e.g. "0.001" for 0.001 BNB, "1" for 1 USDT. Do NOT convert to smallest unit (wei/lamports). Obtained directly from user's chat message.
chain_id_in	number	required	Source chain ID. Use well-known IDs: ETH=1, BSC=56, Polygon=137, Arbitrum=42161, Base=8453, Avalanche=43114, Solana=501. Only call dex_chain_config for uncommon/unknown chains. For single-chain swap, must equal chain_id_out.
chain_id_out	number	required	Destination chain ID. Use same well-known IDs as chain_id_in. For single-chain swap, set equal to chain_id_in. For cross-chain swap, set to the target chain's ID.
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
native_in	number	required	⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_in a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_in=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_in=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_in=1, token_in is auto-normalized to '-'.
native_out	number	required	⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_out a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_out=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_out=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_out=1, token_out is auto-normalized to '-'. CROSS-CHAIN EXAMPLE: USDT(BSC) → SOL(Solana): native_in=0 (USDT is contract token), native_out=1 (SOL is native coin). CROSS-CHAIN EXAMPLE: ETH(Ethereum) → USDT(BSC): native_in=1 (ETH is native coin), native_out=0 (USDT is contract token).
slippage	number	required	Slippage tolerance as decimal ratio: 0.01 = 1%, 0.03 = 3%. Valid range: 0.001 (0.1%) to 0.499 (49.9%). If the user already specified slippage, use it directly. Only ask to confirm when not provided. Default: 0.03 (3%).
to_wallet	string	optional	Destination chain receiving address. ONLY required for CROSS-CHAIN swaps where chain_id_in and chain_id_out belong to different address groups (e.g. EVM→Solana or Solana→EVM). Obtain from dex_wallet_get_addresses: use addresses["SOL"] if dest is Solana, addresses["EVM"] if dest is EVM. Omit for single-chain swaps — defaults to user_wallet.
token_in	string	required	Source token contract address. Use "-" for native coins (ETH, BNB, MATIC, etc.). For ERC20/BEP20 tokens, provide the full contract address (e.g. 0x55d398326f99059ff775485246999027b3197955 for BSC USDT). Obtain from user input, wallet token list (wallet_get_token_list), or known token mappings. If native_in=1, this field will be auto-set to "-".
token_out	string	required	Destination token contract address. Use "-" for native coins. For ERC20/BEP20 tokens, provide the full contract address. Obtain from user input, wallet_get_token_list, or known token mappings. If native_out=1, this field will be auto-set to "-". For cross-chain swaps, use the token's contract address on the destination chain.
user_wallet	string	required	User's wallet address matching the SOURCE CHAIN. CRITICAL: You MUST use the chain-specific address — call dex_wallet_get_addresses(account_id) first, then use addresses["EVM"] for EVM chains (ETH/BSC/Polygon/Arbitrum/Base/Avalanche) or addresses["SOL"] for Solana (chain_id=501). NEVER pass an EVM address (0x...) for Solana transactions or vice versa. For cross-chain swaps this is the FROM (source) chain address.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Human-readable amount of source token to swap, e.g. \"0.001\" for 0.001 BNB, \"1\" for 1 USDT. Do NOT convert to smallest unit (wei/lamports). Obtained directly from user's chat message.",
      "type": "string"
    },
    "chain_id_in": {
      "description": "Source chain ID. Use well-known IDs: ETH=1, BSC=56, Polygon=137, Arbitrum=42161, Base=8453, Avalanche=43114, Solana=501. Only call dex_chain_config for uncommon/unknown chains. For single-chain swap, must equal chain_id_out.",
      "type": "number"
    },
    "chain_id_out": {
      "description": "Destination chain ID. Use same well-known IDs as chain_id_in. For single-chain swap, set equal to chain_id_in. For cross-chain swap, set to the target chain's ID.",
      "type": "number"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "native_in": {
      "description": "⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_in a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_in=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_in=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_in=1, token_in is auto-normalized to '-'.",
      "type": "number"
    },
    "native_out": {
      "description": "⚠️ CRITICAL — Must be set correctly, wrong value causes transaction failure or fund loss. Simply check: is token_out a native/gas coin? If yes, set 1; if it's a contract token, set 0. Native coins: ETH, BNB, MATIC, AVAX, SOL — these are the chain's gas coins, native_out=1. Contract tokens: USDT, USDC, WETH, WBNB, DAI, etc. — these are ERC20/BEP20/SPL tokens, native_out=0. NOTE: BNB = native coin (native=1), WBNB = wrapped contract token (native=0). User saying 'BNB' means the native coin unless they explicitly say 'WBNB'. Same for ETH vs WETH, SOL vs WSOL. When native_out=1, token_out is auto-normalized to '-'. CROSS-CHAIN EXAMPLE: USDT(BSC) → SOL(Solana): native_in=0 (USDT is contract token), native_out=1 (SOL is native coin). CROSS-CHAIN EXAMPLE: ETH(Ethereum) → USDT(BSC): native_in=1 (ETH is native coin), native_out=0 (USDT is contract token).",
      "type": "number"
    },
    "slippage": {
      "description": "Slippage tolerance as decimal ratio: 0.01 = 1%, 0.03 = 3%. Valid range: 0.001 (0.1%) to 0.499 (49.9%). If the user already specified slippage, use it directly. Only ask to confirm when not provided. Default: 0.03 (3%).",
      "type": "number"
    },
    "to_wallet": {
      "description": "Destination chain receiving address. ONLY required for CROSS-CHAIN swaps where chain_id_in and chain_id_out belong to different address groups (e.g. EVM→Solana or Solana→EVM). Obtain from dex_wallet_get_addresses: use addresses[\"SOL\"] if dest is Solana, addresses[\"EVM\"] if dest is EVM. Omit for single-chain swaps — defaults to user_wallet.",
      "type": "string"
    },
    "token_in": {
      "description": "Source token contract address. Use \"-\" for native coins (ETH, BNB, MATIC, etc.). For ERC20/BEP20 tokens, provide the full contract address (e.g. 0x55d398326f99059ff775485246999027b3197955 for BSC USDT). Obtain from user input, wallet token list (wallet_get_token_list), or known token mappings. If native_in=1, this field will be auto-set to \"-\".",
      "type": "string"
    },
    "token_out": {
      "description": "Destination token contract address. Use \"-\" for native coins. For ERC20/BEP20 tokens, provide the full contract address. Obtain from user input, wallet_get_token_list, or known token mappings. If native_out=1, this field will be auto-set to \"-\". For cross-chain swaps, use the token's contract address on the destination chain.",
      "type": "string"
    },
    "user_wallet": {
      "description": "User's wallet address matching the SOURCE CHAIN. CRITICAL: You MUST use the chain-specific address — call dex_wallet_get_addresses(account_id) first, then use addresses[\"EVM\"] for EVM chains (ETH/BSC/Polygon/Arbitrum/Base/Avalanche) or addresses[\"SOL\"] for Solana (chain_id=501). NEVER pass an EVM address (0x...) for Solana transactions or vice versa. For cross-chain swaps this is the FROM (source) chain address.",
      "type": "string"
    }
  },
  "required": [
    "chain_id_in",
    "chain_id_out",
    "token_in",
    "token_out",
    "amount",
    "slippage",
    "user_wallet",
    "native_in",
    "native_out"
  ]
}

dex_tx_swap_sign_approve

[write] Sign the ERC20 approve tx for a staged EVM swap. Requires need_approved=true in prepare result.

Parameters3

checkin_token	string	required	Approve-stage checkin_token returned by the local skill check-in script after dex_tx_swap_checkin_preview(stage='approve')
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
swap_session_id	string	required	Swap session ID returned by dex_tx_swap_prepare

Raw schema

{
  "type": "object",
  "properties": {
    "checkin_token": {
      "description": "Approve-stage checkin_token returned by the local skill check-in script after dex_tx_swap_checkin_preview(stage='approve')",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "swap_session_id": {
      "description": "Swap session ID returned by dex_tx_swap_prepare",
      "type": "string"
    }
  },
  "required": [
    "swap_session_id",
    "checkin_token"
  ]
}

dex_tx_swap_sign_swap

[write] Sign the main swap tx for a staged session. EVM: call sign_approve first if need_approved=true. Solana: generates a fresh signable payload.

Parameters3

checkin_token	string	required	Swap-stage checkin_token returned by the local skill check-in script after dex_tx_swap_checkin_preview(stage='swap')
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
swap_session_id	string	required	Swap session ID returned by dex_tx_swap_prepare

Raw schema

{
  "type": "object",
  "properties": {
    "checkin_token": {
      "description": "Swap-stage checkin_token returned by the local skill check-in script after dex_tx_swap_checkin_preview(stage='swap')",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "swap_session_id": {
      "description": "Swap session ID returned by dex_tx_swap_prepare",
      "type": "string"
    }
  },
  "required": [
    "swap_session_id",
    "checkin_token"
  ]
}

dex_tx_swap_submit

[write] Broadcast a staged swap to the chain. Does not sign. Requires all signing steps complete (sign_approve if EVM+approval, then sign_swap).

Parameters2

mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
swap_session_id	string	required	Swap session ID returned by dex_tx_swap_prepare

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "swap_session_id": {
      "description": "Swap session ID returned by dex_tx_swap_prepare",
      "type": "string"
    }
  },
  "required": [
    "swap_session_id"
  ]
}

dex_tx_transfer_preview

Build unsigned transfer tx; displays summary (sender, recipient, amount, gas). Returns unsigned_tx_hex and txBundle for check-in. Does not broadcast. Wait for user confirmation before signing. → swap_quote/swap_prepare for token exchange.

Parameters13

amount	string	required	Amount in token units. Precision depends on token/decimals. Examples: '1', '0.5', '0.000001'
chain	string	optional	Chain name or alias (default ETH). Resolved to canonical name from chain config; downstream sign/broadcast should use the same logical chain.
from	string	required	Sender (your wallet) address
max_fee_per_gas	string	optional	EVM only: override max fee per gas (wei). Use when replacing a pending tx: set ≥1.1× the previous max_fee_per_gas to fix replacement transaction underpriced.
max_priority_fee_per_gas	string	optional	EVM only: override max priority fee per gas (wei). When replacing, set ≥1.1× previous max_priority_fee_per_gas.
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
nonce	string	optional	Transaction nonce. Omit to use current chain nonce (eth_getTransactionCount), ensuring tx can be mined and found on explorer; wrong nonce causes tx to fail or not appear.
priority_fee_micro_lamports	string	optional	Solana only: optional priority fee (micro-lamports per compute unit). Use 1000-10000 if broadcast returns replacement transaction underpriced.
to	string	required	Recipient address
token	string	optional	Token symbol for display (default USDT). Use ETH/NATIVE for native; USDT for USDT; or use token_contract/token_mint for any token.
token_contract	string	optional	EVM: ERC20 contract address for arbitrary token. When set, token_decimals is used (default 18). Solana: unused.
token_decimals	string	optional	Token decimals (e.g. 6, 18). Required when using token_contract (EVM) or token_mint (Solana); default 18 for ERC20, 9 for SOL.
token_mint	string	optional	Solana: SPL token mint address for SPL transfer. When set, token_decimals is required. EVM: unused.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Amount in token units. Precision depends on token/decimals. Examples: '1', '0.5', '0.000001'",
      "type": "string"
    },
    "chain": {
      "description": "Chain name or alias (default ETH). Resolved to canonical name from chain config; downstream sign/broadcast should use the same logical chain.",
      "type": "string"
    },
    "from": {
      "description": "Sender (your wallet) address",
      "type": "string"
    },
    "max_fee_per_gas": {
      "description": "EVM only: override max fee per gas (wei). Use when replacing a pending tx: set ≥1.1× the previous max_fee_per_gas to fix replacement transaction underpriced.",
      "type": "string"
    },
    "max_priority_fee_per_gas": {
      "description": "EVM only: override max priority fee per gas (wei). When replacing, set ≥1.1× previous max_priority_fee_per_gas.",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "nonce": {
      "description": "Transaction nonce. Omit to use current chain nonce (eth_getTransactionCount), ensuring tx can be mined and found on explorer; wrong nonce causes tx to fail or not appear.",
      "type": "string"
    },
    "priority_fee_micro_lamports": {
      "description": "Solana only: optional priority fee (micro-lamports per compute unit). Use 1000-10000 if broadcast returns replacement transaction underpriced.",
      "type": "string"
    },
    "to": {
      "description": "Recipient address",
      "type": "string"
    },
    "token": {
      "description": "Token symbol for display (default USDT). Use ETH/NATIVE for native; USDT for USDT; or use token_contract/token_mint for any token.",
      "type": "string"
    },
    "token_contract": {
      "description": "EVM: ERC20 contract address for arbitrary token. When set, token_decimals is used (default 18). Solana: unused.",
      "type": "string"
    },
    "token_decimals": {
      "description": "Token decimals (e.g. 6, 18). Required when using token_contract (EVM) or token_mint (Solana); default 18 for ERC20, 9 for SOL.",
      "type": "string"
    },
    "token_mint": {
      "description": "Solana: SPL token mint address for SPL transfer. When set, token_decimals is required. EVM: unused.",
      "type": "string"
    }
  },
  "required": [
    "from",
    "to",
    "amount"
  ]
}

dex_tx_x402_checkin_preview

Prepare Gate Verify tx_checkin for x402 (EVM exact / EIP-3009 only): returns tx_checkin.message (64-hex digest) and x402_payment_required_b64 without signing. Flow: 1) this tool 2) Gate Verify tx_checkin with returned tx_checkin fields 3) dex_tx_x402_fetch with same url/body/headers, checkin_token, and the same x402_payment_required_b64. If x402_payment_required_b64 is omitted, performs one HTTP call and requires HTTP 402.

Parameters7

body	string	optional	Optional request body
headers	string	optional	Optional JSON object of request headers
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
method	string	optional	HTTP method; default GET
url	string	required	Same URL as dex_tx_x402_fetch
x402_payment_required_b64	string	optional	Optional: PAYMENT-REQUIRED header base64; when omitted, one outbound request is made and must return 402
x402_preferred_network	string	optional	Same as dex_tx_x402_fetch

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "description": "Optional request body",
      "type": "string"
    },
    "headers": {
      "description": "Optional JSON object of request headers",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "method": {
      "description": "HTTP method; default GET",
      "type": "string"
    },
    "url": {
      "description": "Same URL as dex_tx_x402_fetch",
      "type": "string"
    },
    "x402_payment_required_b64": {
      "description": "Optional: PAYMENT-REQUIRED header base64; when omitted, one outbound request is made and must return 402",
      "type": "string"
    },
    "x402_preferred_network": {
      "description": "Same as dex_tx_x402_fetch",
      "type": "string"
    }
  },
  "required": [
    "url"
  ]
}

dex_tx_x402_fetch

[write] Send an HTTP request to the given URL. If the server responds with 402 Payment Required, pay via x402 (Coinbase-style: USDC EIP-3009 / Permit2 on EVM, SPL on Solana), retry with PAYMENT-SIGNATURE. REQUIRED: Gate Verify tx_checkin before signing; pass checkin_token. For EVM EIP-3009, use dex_tx_x402_checkin_preview first so the agent does not build digest manually; then pass checkin_token and the same x402_payment_required_b64 from preview. CoinGecko Pro x402: do not send x-cg-pro-api-key; default network Base unless x402_preferred_network=solana.

Parameters8

body	string	optional	Optional request body
checkin_token	string	required	From Gate Verify MCP tool tx_checkin success (e.g. structuredContent.data.checkin_token or data.checkin_token). Required before every call so GV can verify signing.
headers	string	optional	Optional JSON object of request headers
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
method	string	optional	HTTP method; default GET
url	string	required	Request URL (CoinGecko x402: https://pro-api.coingecko.com/api/v3/x402/...)
x402_payment_required_b64	string	optional	Optional: base64 PAYMENT-REQUIRED header payload from the same 402 as EIP-3009 tx-checkin. When set, skips the first HTTP call and pays using this snapshot (digest/checkin_token must match).
x402_preferred_network	string	optional	Optional: base, eth, solana, eip155:8453, ... — restrict which accept.network is used. CoinGecko Pro /x402/ defaults to base when omitted.

Raw schema

{
  "type": "object",
  "properties": {
    "body": {
      "description": "Optional request body",
      "type": "string"
    },
    "checkin_token": {
      "description": "From Gate Verify MCP tool tx_checkin success (e.g. structuredContent.data.checkin_token or data.checkin_token). Required before every call so GV can verify signing.",
      "type": "string"
    },
    "headers": {
      "description": "Optional JSON object of request headers",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "method": {
      "description": "HTTP method; default GET",
      "type": "string"
    },
    "url": {
      "description": "Request URL (CoinGecko x402: https://pro-api.coingecko.com/api/v3/x402/...)",
      "type": "string"
    },
    "x402_payment_required_b64": {
      "description": "Optional: base64 PAYMENT-REQUIRED header payload from the same 402 as EIP-3009 tx-checkin. When set, skips the first HTTP call and pays using this snapshot (digest/checkin_token must match).",
      "type": "string"
    },
    "x402_preferred_network": {
      "description": "Optional: base, eth, solana, eip155:8453, ... — restrict which accept.network is used. CoinGecko Pro /x402/ defaults to base when omitted.",
      "type": "string"
    }
  },
  "required": [
    "url",
    "checkin_token"
  ]
}

dex_wallet_bind_exchange_uid

Bind Gate exchange UID to session. Standalone Gate session only; gateUid must equal login_result.gate_uid from Gate OAuth. → replace_binding to rebind.

Parameters2

gateUid	string	required	Must equal login_result.gate_uid from Gate OAuth that created this session
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "gateUid": {
      "description": "Must equal login_result.gate_uid from Gate OAuth that created this session",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": [
    "gateUid"
  ]
}

dex_wallet_get_addresses

Returns address map by chain type (EVM, SOL, etc.). Call before transfer/swap tools to get the sender address.

Parameters2

account_id	string	required	Account ID
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": [
    "account_id"
  ]
}

dex_wallet_get_bindings

Returns current Gate UID binding for the session wallet.

Parameters1

mcp_token

string

optional

MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": []
}

dex_wallet_get_token_list

Token balances and prices with pagination; filter by network_keys. → get_total_asset for portfolio summary only.

Parameters5

account_id	string	optional	Account ID (optional, auto-detected from login session)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
network_keys	string	optional	Optional. Comma-separated network keys to filter (e.g. ETH,SOL,ARB). Omit or leave empty for all networks. Do not pass a separate chain field — use network_keys only.
page	number	optional	Page number, default 1
page_size	number	optional	Page size, default 20

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID (optional, auto-detected from login session)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "network_keys": {
      "description": "Optional. Comma-separated network keys to filter (e.g. ETH,SOL,ARB). Omit or leave empty for all networks. Do not pass a separate chain field — use network_keys only.",
      "type": "string"
    },
    "page": {
      "description": "Page number, default 1",
      "type": "number"
    },
    "page_size": {
      "description": "Page size, default 20",
      "type": "number"
    }
  },
  "required": []
}

dex_wallet_get_total_asset

Total portfolio value and 24h change. → get_token_list for per-token balance detail.

Parameters2

account_id	string	optional	Account ID (optional, auto-detected from login session)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID (optional, auto-detected from login session)",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": []
}

dex_wallet_get_wallet_type

Returns walletAddress, walletType, gateUid. With for_withdraw_to_exchange or for_gate_oauth_bind, also starts Gate OAuth when gateUid is missing.

Parameters5

account_id	string	optional	Account ID; used with session to resolve EVM address if wallet_address omitted
for_gate_oauth_bind	boolean	optional	Bind/rebind Gate exchange: when walletType is NOT gate_mcp/gate_quick, start Gate OAuth (Google: link); when already Gate-native with gateUid, returns nextSteps only
for_withdraw_to_exchange	boolean	optional	Withdraw-to-exchange: when gateUid is missing, start Gate device OAuth (Google: link binding)
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
wallet_address	string	optional	EVM wallet address to classify

Raw schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "description": "Account ID; used with session to resolve EVM address if wallet_address omitted",
      "type": "string"
    },
    "for_gate_oauth_bind": {
      "description": "Bind/rebind Gate exchange: when walletType is NOT gate_mcp/gate_quick, start Gate OAuth (Google: link); when already Gate-native with gateUid, returns nextSteps only",
      "type": "boolean"
    },
    "for_withdraw_to_exchange": {
      "description": "Withdraw-to-exchange: when gateUid is missing, start Gate device OAuth (Google: link binding)",
      "type": "boolean"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "wallet_address": {
      "description": "EVM wallet address to classify",
      "type": "string"
    }
  },
  "required": []
}

dex_wallet_google_gate_bind_start

Google sessions only: starts Gate OAuth to bind Gate exchange UID to this session. mcp_token stays unchanged after poll.

Parameters1

mcp_token

string

optional

MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    }
  },
  "required": []
}

dex_wallet_replace_binding

Rebind Gate exchange UID. [write] newUid must equal login_result.gate_uid from a fresh Gate OAuth. Blocked for gate_mcp/gate_quick sessions and Google sessions.

Parameters2

mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
newUid	string	required	Must equal login_result.gate_uid from latest Gate OAuth (stamped on session)

Raw schema

{
  "type": "object",
  "properties": {
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "newUid": {
      "description": "Must equal login_result.gate_uid from latest Gate OAuth (stamped on session)",
      "type": "string"
    }
  },
  "required": [
    "newUid"
  ]
}

dex_wallet_sign_message

Sign a 32-byte hex message with wallet key. [write] Requires checkin_token from terminal tx-checkin. → sign_transaction for raw tx signing.

Parameters4

chain	string	required	Chain: dex_chain_config name/alias (e.g. ETH, BSC, SOL), or pass EVM / SOL directly for the signing family. Unknown names are rejected via chain config; web3_business_wallet sign-message receives chain "EVM" or lowercase "sol" for Solana.
checkin_token	string	required	From successful tx-checkin response: the checkin_token string (terminal CLI stdout JSON). Must match the signing intent in the same flow.
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
message	string	required	Message to sign (hex)

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain: dex_chain_config name/alias (e.g. ETH, BSC, SOL), or pass EVM / SOL directly for the signing family. Unknown names are rejected via chain config; web3_business_wallet sign-message receives chain \"EVM\" or lowercase \"sol\" for Solana.",
      "type": "string"
    },
    "checkin_token": {
      "description": "From successful tx-checkin response: the checkin_token string (terminal CLI stdout JSON). Must match the signing intent in the same flow.",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "message": {
      "description": "Message to sign (hex)",
      "type": "string"
    }
  },
  "required": [
    "message",
    "chain",
    "checkin_token"
  ]
}

dex_wallet_sign_transaction

Sign a raw unsigned transaction. [write] Requires user confirmation after transfer preview and checkin_token from terminal tx-checkin. → dex_tx_send_raw_transaction to broadcast.

Parameters4

chain	string	required	Chain name: must match dex_chain_config response `chain` (canonical). Aliases are resolved via chain config.
checkin_token	string	required	From successful tx-checkin response: the checkin_token string (terminal CLI stdout JSON). Must match the signing intent in the same flow.
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
raw_tx	string	required	Raw transaction data

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "description": "Chain name: must match dex_chain_config response `chain` (canonical). Aliases are resolved via chain config.",
      "type": "string"
    },
    "checkin_token": {
      "description": "From successful tx-checkin response: the checkin_token string (terminal CLI stdout JSON). Must match the signing intent in the same flow.",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "raw_tx": {
      "description": "Raw transaction data",
      "type": "string"
    }
  },
  "required": [
    "raw_tx",
    "chain",
    "checkin_token"
  ]
}

dex_withdraw_deposit_address

Fetch Gate exchange deposit address for the session-bound Gate UID. [write] amount must be ≥ min_deposit_amount; do not pass uid — it is resolved from the session.

Parameters5

amount	string	required	Required. Human-readable amount (same units as on-chain transfer); must be ≥ exchange min_deposit_amount
chain_name	string	required	Chain name, e.g. BSC, ETH
coin_symbol	string	required	Coin symbol, e.g. USDT
mcp_token	string	optional	MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403
token_address	string	optional	Optional. ERC20 contract for gate-deposit; empty for native. If omitted, USDT is resolved from chain_name; other symbols may require this field

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Required. Human-readable amount (same units as on-chain transfer); must be ≥ exchange min_deposit_amount",
      "type": "string"
    },
    "chain_name": {
      "description": "Chain name, e.g. BSC, ETH",
      "type": "string"
    },
    "coin_symbol": {
      "description": "Coin symbol, e.g. USDT",
      "type": "string"
    },
    "mcp_token": {
      "description": "MCP session token obtained from login (dex_auth_google_login_poll or dex_auth_gate_login_poll). MUST be provided in every call to this tool after login; omitting it will result in 403",
      "type": "string"
    },
    "token_address": {
      "description": "Optional. ERC20 contract for gate-deposit; empty for native. If omitted, USDT is resolved from chain_name; other symbols may require this field",
      "type": "string"
    }
  },
  "required": [
    "chain_name",
    "coin_symbol",
    "amount"
  ]
}

README.md24 KBView on GitHub

Gate MCP Server

English | 中文

A Gate MCP (Model Context Protocol) server that enables AI agents to interact with the Gate cryptocurrency exchange for market data, trading, and account management.

Features

🔍 Public Market Data - Spot, futures, margin, options, delivery, earn, alpha tickers, order books, K-line, funding rate, liquidation history (no auth required)
💹 Trading - Create/cancel/amend spot, futures, options, delivery orders; price-triggered orders; trail orders
💼 Account & Wallet - Balances, transfers, deposits, withdrawals, sub-accounts, unified account
📊 Margin & Earn - Margin loans, earn products, multi-currency flash swap
🎯 Activity & Welfare - Activity center, coupons, launch pool, square, welfare
🌍 TradFi, CrossEx, P2P - Traditional finance, cross-exchange, P2P trading
🌐 DEX - On-chain wallet, swap (single-chain & cross-chain), token info, market data across 20+ chains
📰 Info - Coin discovery, market snapshots, technical/platform metrics, on-chain and macro data
📢 News - Crypto news, social insights, market events, prediction markets
📚 Docs - Research reports, papers, and documentation search
🔐 OAuth2 - Secure authorization for trading and private tools

MCP Endpoints

The service exposes the following MCP endpoints:

Endpoint	Auth	Tools
`https://api.gatemcp.ai/mcp`	None	Public market data (58 tools: spot, futures, margin, options, delivery, earn, alpha, activity, launch pool, square, flash swap)
`https://api.gatemcp.ai/mcp/exchange`	OAuth2	CEX trading & account (400+ tools: spot/futures/options/delivery/margin trading, wallet, unified account, sub-accounts, earn, flash swap, rebate, TradFi, CrossEx, P2P, Alpha, activity center, coupon, launch pool, square, welfare)
`https://api.gatemcp.ai/mcp/dex`	Google / Gate OAuth	DEX wallet & swap (33 tools: auth, wallet, chain config, transfer, swap, market data, token info, agentic, RPC across 20+ chains)
`https://api.gatemcp.ai/mcp/info`	None	Coin info & analysis (32 tools: coins, snapshots, trends, on-chain, platform metrics, macro, market detail)
`https://api.gatemcp.ai/mcp/open/info`	None	Gate Info submission surface (exactly 7 tools: coin profile, market overview/snapshots, kline, order book, recent trades)
`https://api.gatemcp.ai/mcp/news`	None	News & research (18 tools: news/UGC/X/web, announcements, sentiment, events, prediction markets)
`https://api.gatemcp.ai/mcp/docs`	None	Docs research (3 tools: research search, coin research, papers)

Market data only → Use /mcp (no Gate account needed)
CEX trading, balances, transfers → Use /mcp/exchange (Gate OAuth2 required)
DEX wallet, swap, on-chain → Use /mcp/dex (Google / Gate OAuth required)
Coin info, technical analysis → Use /mcp/info (no auth)
ChatGPT / OpenAI Apps Gate Info listing → Use /mcp/open/info (7-tool allowlist; no auth)
News, announcements → Use /mcp/news (no auth)
Research docs & papers → Use /mcp/docs (no auth)

Transport: Streamable HTTP (with SSE fallback).

Authorization (OAuth2)

/mcp/exchange requires Gate OAuth2; /mcp/dex requires Google or Gate OAuth. The endpoints /mcp, /mcp/info, /mcp/open/info, /mcp/news, and /mcp/docs do not require any authentication.

Using mcporter

Prerequisites: Node.js >= 18, npm. See Quick Start - mcporter for full installation steps.

bash

# Add Private MCP (trading, requires OAuth)
mcporter config add gate-mcp --url https://api.gatemcp.ai/mcp/exchange --auth oauth

# Authorize (opens browser to log in)
mcporter auth gate-mcp

Scopes (for `/mcp/exchange`)

Scope	Use
`market`	Public market data (tickers, order books, K-line, etc.)
`profile`	Account info, orders, positions (read-only)
`trade`	Create/cancel/amend orders
`wallet`	Transfers, deposits, withdrawals
`account`	Unified account, sub-accounts

Quick Start

Prerequisites

Gate account (required only for /mcp/exchange)
MCP-compatible client (Cursor, Claude CLI, Trae, OpenClaw, etc.)
Node.js >= 18 (for mcporter, Trae, Qoder, and other npm-based clients)
Python >= 3.9 (optional, for Claude Desktop proxy)

Cursor

Method 1: One-click Install (Recommended)

Just paste the following into the Cursor AI chat — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

For full trading (OAuth on connect):

Edit ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "Gate": {
      "url": "https://api.gatemcp.ai/mcp/exchange",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

For market data only (no auth):

json

{
  "mcpServers": {
    "Gate": {
      "url": "https://api.gatemcp.ai/mcp",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

For DEX (on-chain wallet, swap):

json

{
  "mcpServers": {
    "Gate-Dex": {
      "url": "https://api.gatemcp.ai/mcp/dex",
      "headers": {
        "x-api-key": "MCP_AK_8W2N7Q",
        "Authorization": "Bearer ${GATE_MCP_TOKEN}"
      }
    }
  }
}

For Info & News (no auth):

json

{
  "mcpServers": {
    "Gate-Info": {
      "url": "https://api.gatemcp.ai/mcp/info"
    },
    "Gate-News": {
      "url": "https://api.gatemcp.ai/mcp/news"
    }
  }
}

See Cursor setup.

mcporter / OpenClaw

Method 1: One-click Install (Recommended)

Just paste the following into the OpenClaw AI chat — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

Prerequisites (before installing mcporter)

Node.js >= 18 (mcporter requires npm)
npm (comes with Node.js) — verify with: node -v and npm -v
Gate account (for OAuth login when using /mcp/exchange)

Install mcporter

bash

# Global install
npm install -g mcporter

# Verify installation
mcporter --version

Alternatively, run without installing: npx mcporter <command> (uses current Node.js/npm).

Add MCP and authorize

bash

# Add Private MCP (trading, OAuth)
mcporter config add gate-mcp --url https://api.gatemcp.ai/mcp/exchange --auth oauth

# Authorize (opens browser to log in)
mcporter auth gate-mcp

# Add DEX MCP
mcporter config add gate-dex --url https://api.gatemcp.ai/mcp/dex

# Add Info MCP (no auth)
mcporter config add gate-info --url https://api.gatemcp.ai/mcp/info

# Add News MCP (no auth)
mcporter config add gate-news --url https://api.gatemcp.ai/mcp/news

See OpenClaw setup for detailed steps.

Claude CLI

Method 1: One-click Install (Recommended)

Just paste the following into Claude CLI — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

bash

brew install claude-code
# Full trading (OAuth)
claude mcp add --transport http Gate https://api.gatemcp.ai/mcp/exchange
# Restart Claude CLI after authorization is complete

# Info (no auth)
claude mcp add --transport http Gate-Info https://api.gatemcp.ai/mcp/info

# News (no auth)
claude mcp add --transport http Gate-News https://api.gatemcp.ai/mcp/news

claude mcp list

Trae

Edit Trae settings. Uses mcp-remote to proxy HTTP MCP (OAuth prompt on first connect for /mcp/exchange):

json

{
  "mcpServers": {
    "gate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/exchange"
      ]
    },
    "gate-info": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/info"
      ]
    },
    "gate-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/news"
      ]
    }
  }
}

Qoder

Edit Qoder MCP settings (e.g. ~/.qoder/mcp.json or in Qoder settings):

json

{
  "mcpServers": {
    "gate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/exchange"
      ]
    },
    "gate-info": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/info"
      ]
    },
    "gate-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/news"
      ]
    }
  }
}

Claude Desktop

Claude Desktop requires a local stdio proxy.

Download the Python proxy file
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "Gate": {
      "command": "python3",
      "args": ["/path/to/gate-mcp-proxy.py"]
    }
  }
}

See Claude Desktop setup for detailed instructions.

Alternative: gate-local-mcp (local stdio with API keys)

For local development without OAuth, use gate-local-mcp (npm: gate-mcp) — a stdio MCP server that uses GATE_API_KEY / GATE_API_SECRET (optional for public market data only). Configure it as a command-based MCP server (e.g. "command": "npx", "args": ["-y", "gate-mcp"]). By default it registers 384 tools across 22 modules (spot, futures, delivery, margin, wallet, account, options, earn, flash_swap, unified, sub_account, multi_collateral_loan, p2p, tradfi, crossex, alpha, rebate, activity, coupon, launch, square, welfare). Reduce the set with GATE_MODULES or --modules=spot,futures, or enable read-only mode with GATE_READONLY=true / --readonly.

Important: Wire-level tool names use abbreviations (futures→fx, delivery→dc, sub_account→sa, etc.); they differ from the remote api.gatemcp.ai naming. Always use the names returned by tools/list.

Full tool list: gate-local-mcp-tools.md.

LobeHub (desktop)

On the LobeHub MCP marketplace this server appears as identifier gate-gate-mcp. The npm package name is gate-mcp — run npx -y gate-mcp, not gate-gate-mcp.

Per LobeHub custom MCP, stdio servers work on the desktop app only; inject environment variables for Gate API authentication. Use Import JSON when adding a custom skill.

Public endpoints only:

json

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": ["-y", "gate-mcp"],
      "type": "stdio"
    }
  }
}

With API key authentication:

json

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": ["-y", "gate-mcp"],
      "type": "stdio",
      "env": {
        "GATE_API_KEY": "your-api-key",
        "GATE_API_SECRET": "your-api-secret"
      }
    }
  }
}

You can add GATE_MODULES, GATE_READONLY, or GATE_BASE_URL inside env as needed. Click Test connection before saving.

Other Clients

Client	Guide
Claude.ai	setup
Codex App	setup
Codex CLI	setup
OpenClaw	setup
Trae	See Trae config above
Qoder	See Qoder config above

Basic Usage

Query Price

What's the current price of BTC/USDT?

Get Order Book

Show me the order book for ETH/USDT

K-line Data

Get the daily K-line data for BTC over the last 7 days

Available Tools

All tools use the cex_ prefix. Tools are split between Public MCP (no auth) and Private MCP (OAuth2).

Public MCP (`/mcp` — no auth, 58 tools)

Business	Tools	Description
Spot	8	`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`
Futures	14	Contracts, order book, trades, candlesticks, tickers, funding rate, premium index, liquidation, contract stats, insurance ledger, index constituents, batch funding rates, risk limit tiers
Margin	3	`cex_margin_list_uni_currency_pairs`, `cex_margin_get_uni_currency_pair`, `cex_margin_get_market_margin_tier`
Options	12	Underlyings, expirations, contracts, settlements, order book, tickers, candlesticks, trades
Delivery	8	Contracts, order book, trades, candlesticks, tickers, insurance ledger, risk limit tiers
Earn	5	`cex_earn_list_dual_investment_plans`, `cex_earn_list_structured_products`, `cex_earn_list_uni_currencies`, `cex_earn_list_earn_fixed_term_products`, `cex_earn_list_earn_fixed_term_products_by_asset`
Alpha	3	`cex_alpha_list_alpha_currencies`, `cex_alpha_list_alpha_tickers`, `cex_alpha_list_alpha_tokens`
Activity	1	`cex_activity_list_activity_types`
Launch	1	`cex_launch_list_launch_pool_projects`
Square	2	`cex_square_list_square_ai_search`, `cex_square_list_live_replay`
Flash Swap	1	`cex_fc_list_fc_currency_pairs`

Private MCP (`/mcp/exchange` — OAuth2, 400+ tools)

Note: The private endpoint does not include public market data tools. Use /mcp for market data queries.

Business	Scope	Key Tools
Spot	profile / trade	Accounts, orders, trades, batch orders, price-triggered orders, countdown cancel, cross liquidate
Futures	profile / trade	Accounts, positions, orders, trades, dual positions, trail orders, price-triggered, BBO orders
Margin	profile / trade	Margin accounts, loans, auto-repay, uni loans
Options	profile / trade	Account, positions, orders, MMP settings
Delivery	profile / trade	Accounts, positions, orders, price-triggered orders
Wallet	wallet	Total balance, transfers, deposits, withdrawals, deposit address, SA balances, small balance convert
Unified	account	Unified accounts, mode, loans, risk units, borrowable, collateral, leverage config
Sub-account	account	Create/list/lock/unlock SA, API keys
Account	account	Account detail, main keys, rate limit, debit fee, STP groups
Rebate	profile	Agency/partner/broker commission history, user info
Flash Swap	profile / trade	`cex_fc_list_fc_currency_pairs`, `cex_fc_list_fc_orders`, `cex_fc_create_fc_order_v1`, multi-currency flash swap
Earn	profile / trade	Dual/structured/uni products, orders, ETH2 swap, lend records
Alpha	profile / trade	Alpha accounts, orders, quote/place
TradFi	profile / trade	Categories, symbols, MT5 account, assets, orders, positions
CrossEx	profile / trade	Rule symbols, account, positions, orders, transfers, convert
P2P	profile / trade	User info, ads, chats, transactions, confirm payment/receipt
Activity	profile	Activity types, recommended activities, user participation
Coupon	profile	User coupons, coupon details
Launch Pool	profile / trade	LaunchPool projects, pledge/redeem, reward records
Square	market	AI search, live replay
Welfare	profile	Beginner eligibility, task list and rewards

For full tool parameters, see Gate API Docs or gate-exchange-mcp.

DEX — Authentication

Tool	Description
`dex_auth_google_login_start`	Start Google OAuth login flow, returns verification URL
`dex_auth_google_login_poll`	Poll login status, returns mcp_token on success
`dex_auth_login_google_wallet`	Login with Google OAuth authorization code
`dex_auth_gate_login_start`	Start Gate OAuth login flow, returns verification URL
`dex_auth_gate_login_poll`	Poll Gate OAuth login status, returns mcp_token on success
`dex_auth_login_gate_wallet`	Login directly with Gate OAuth authorization code
`dex_auth_logout`	Revoke current session

DEX — Wallet

Tool	Description
`dex_wallet_get_addresses`	Get wallet addresses for each chain (EVM, Solana)
`dex_wallet_get_token_list`	Token balances with prices and pagination
`dex_wallet_get_total_asset`	Total portfolio value and 24h change
`dex_wallet_sign_message`	Sign a message with wallet private key (EVM / Solana)
`dex_wallet_sign_transaction`	Sign a raw transaction with wallet private key

DEX — Chain & Transactions

Tool	Description
`dex_chain_config`	Chain configuration (chain ID, capabilities)
`dex_tx_gas`	Estimate gas price and gas limit
`dex_tx_transfer_preview`	Preview transfer details before signing
`dex_tx_approve_preview`	Token approval preview: build ERC20/SPL approve transaction
`dex_tx_get_sol_unsigned`	Build unsigned Solana SOL transfer with latest blockhash
`dex_tx_send_raw_transaction`	Broadcast signed transaction on-chain
`dex_tx_quote`	Swap quote with route, price impact and gas estimation
`dex_tx_swap`	One-click swap: quote → build → sign → submit
`dex_tx_swap_detail`	Query swap order status by order ID
`dex_tx_list` / `dex_tx_detail` / `dex_tx_history_list`	Transaction & swap / bridge history

DEX — Market Data & Token Info

Tool	Description
`dex_market_get_kline`	K-line (candlestick) data: 1m, 5m, 1h, 4h, 1d
`dex_market_get_tx_stats`	Trading volume and trader statistics (5m / 1h / 4h / 24h)
`dex_market_get_pair_liquidity`	Liquidity pool add / remove events
`dex_token_list_swap_tokens`	Available tokens for swap on a given chain
`dex_token_list_cross_chain_bridge_tokens`	Bridgeable tokens for cross-chain transfers
`dex_token_get_coin_info`	Token info: price, market cap, supply, holder distribution
`dex_token_ranking`	24h top gainers / top losers
`dex_token_get_coins_range_by_created_at`	Discover new tokens by creation time range
`dex_token_get_risk_info`	Security audit: honeypot, buy/sell tax, blacklist, permissions

DEX — Agentic & RPC

Tool	Description
`dex_agentic_report`	Report agentic wallet addresses to wallet service
`dex_rpc_call`	Execute JSON-RPC call to blockchain node

For full DEX tool parameters, see gate-dex-mcp. For the Agentic Wallet subset (auth, wallet, market data, resources), see gate-agentic-wallet-mcp.

Info (`/mcp/info` — 32 tools, no auth)

Public, read-only market research. Categories (full parameter tables: gate-info-mcp):

Category	Tools
Coin	`info_coin_get_coin_info`, `info_coin_search_coins`, `info_coin_get_coin_rankings`
Market snapshot	`info_marketsnapshot_get_market_snapshot`, `info_marketsnapshot_batch_market_snapshot`, `info_marketsnapshot_get_market_overview`, `info_marketsnapshot_get_institutional_metrics`
Market trend	`info_markettrend_get_kline`, `info_markettrend_get_indicator_history`, `info_markettrend_get_technical_analysis`
On-chain	`info_onchain_get_address_info`, `info_onchain_get_address_transactions`, `info_onchain_get_transaction`, `info_onchain_get_token_onchain`
Compliance	`info_compliance_check_token_security`
Platform metrics	`info_platformmetrics_get_platform_info`, `info_platformmetrics_search_platforms`, `info_platformmetrics_get_defi_overview`, `info_platformmetrics_get_stablecoin_info`, `info_platformmetrics_get_bridge_metrics`, `info_platformmetrics_get_yield_pools`, `info_platformmetrics_get_platform_history`, `info_platformmetrics_get_exchange_reserves`, `info_platformmetrics_get_liquidation_heatmap`, `info_platformmetrics_get_cex_orderbook_depth`, `info_platformmetrics_get_chain_activity`
Macro	`info_macro_get_macro_indicator`, `info_macro_get_economic_calendar`, `info_macro_get_macro_summary`
Market detail	`info_marketdetail_get_orderbook`, `info_marketdetail_get_recent_trades`, `info_marketdetail_get_kline`

Open Info (`/mcp/open/info` — 7 tools, no auth)

ChatGPT / OpenAI Apps submission allowlist only. Full parameter tables: gate-open-info-mcp.

Category	Tools
Coin	`info_coin_get_coin_info`
Market snapshot	`info_marketsnapshot_get_market_overview`, `info_marketsnapshot_get_market_snapshot`, `info_marketsnapshot_batch_market_snapshot`
Market detail	`info_marketdetail_get_kline`, `info_marketdetail_get_orderbook`, `info_marketdetail_get_recent_trades`

News (`/mcp/news` — 18 tools, no auth)

Public, read-only news and social research. Categories (full parameter tables: gate-news-mcp):

Category	Tools
News feed	`news_feed_search_news`, `news_feed_web_search`, `news_feed_search_x`, `news_feed_search_ugc`, `news_feed_get_exchange_announcements`, `news_feed_get_social_sentiment`, `news_feed_get_mention_burst`, `news_feed_get_hot_topics`
Events	`news_events_get_latest_events`, `news_events_get_event_detail`, `news_events_explain_market_move`, `news_events_get_market_move_report`, `news_events_list_market_move_reports`
Prediction	`news_prediction_get_volume_delta_ranking`, `news_prediction_get_fastest_rising_ranking`, `news_prediction_get_market_orderbook`, `news_prediction_search_events`, `news_prediction_get_event_signal`

MCP Resources

The /mcp and /mcp/exchange endpoints also expose MCP Resources for static reference data:

Resource URI	Description
`gate://spot/currency_pairs`	All spot trading pairs
`gate://spot/currencies`	All supported currencies
`gate://futures/contracts/usdt`	USDT-settled futures contracts
`gate://futures/contracts/btc`	BTC-settled futures contracts
`gate://futures/contracts/{settle}`	Futures contracts by settlement currency

FAQ

Q: Do I need a Gate account?

A: Only for CEX trading and DEX wallet. /mcp, /mcp/info, /mcp/open/info, /mcp/news, and /mcp/docs are fully public — no account needed. /mcp/exchange (CEX trading, balances, transfers) requires Gate OAuth2. /mcp/dex (on-chain wallet, swap) requires Google or Gate OAuth.

Q: Does it support trading?

A: Yes. Connect to https://api.gatemcp.ai/mcp/exchange with OAuth2. The server supports spot and futures trading, account management, wallet transfers, and sub-accounts. Each tool requires the appropriate scope (e.g. trade, wallet).

Q: How often is the data updated?

A: Data is queried in real-time from Gate's API.

Privacy & Security

OAuth2 authorization via Gate account (no API keys stored in config)
All API calls use HTTPS
See Gate Privacy Policy

Support & Feedback

API Documentation: Gate API Docs
Issue Reporting: Please contact Gate support
Business Inquiries: Contact Gate official channels

Contributing

See CONTRIBUTING.md.

License

MIT © gate.com

Install

Tools (47)

dex_agentic_reportdex_auth_gate_login_polldex_auth_gate_login_startdex_auth_google_login_polldex_auth_google_login_startdex_auth_login_gate_walletdex_auth_login_google_walletdex_auth_logout

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.gatemcp.ai/mcp/dex

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "gate-dex": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gatemcp.ai/mcp/dex"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.gateio-dev/gate-dex MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

dex_agentic_report

dex_auth_gate_login_poll

dex_auth_gate_login_start

dex_auth_google_login_poll

dex_auth_google_login_start

dex_auth_login_gate_wallet

dex_auth_login_google_wallet

dex_auth_logout

dex_chain_config

dex_market_get_kline

dex_market_get_pair_liquidity

dex_market_get_tx_stats

dex_rpc_call

dex_token_get_coin_info

dex_token_get_coins_range_by_created_at

dex_token_get_risk_info

dex_token_list_cross_chain_bridge_tokens

dex_token_list_swap_tokens

dex_token_ranking

dex_tx_approve_preview

dex_tx_detail

dex_tx_gas

dex_tx_get_sol_unsigned

dex_tx_list

dex_tx_send_raw_transaction

dex_tx_swap_checkin_preview

dex_tx_swap_detail

dex_tx_swap_history_list

dex_tx_swap_prepare

dex_tx_swap_quote

dex_tx_swap_sign_approve

dex_tx_swap_sign_swap

dex_tx_swap_submit

dex_tx_transfer_preview

dex_tx_x402_checkin_preview

dex_tx_x402_fetch

dex_wallet_bind_exchange_uid

dex_wallet_get_addresses

dex_wallet_get_bindings

dex_wallet_get_token_list

dex_wallet_get_total_asset

dex_wallet_get_wallet_type

dex_wallet_google_gate_bind_start

dex_wallet_replace_binding

dex_wallet_sign_message

dex_wallet_sign_transaction

dex_withdraw_deposit_address

Gate MCP Server

Features

MCP Endpoints

Authorization (OAuth2)

Using mcporter

Scopes (for /mcp/exchange)

Quick Start

Prerequisites

Cursor

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

mcporter / OpenClaw

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

Prerequisites (before installing mcporter)

Install mcporter

Add MCP and authorize

Claude CLI

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

Trae

Qoder

Claude Desktop

Alternative: gate-local-mcp (local stdio with API keys)

LobeHub (desktop)

Other Clients

Basic Usage

Available Tools

Scopes (for `/mcp/exchange`)

Public MCP (`/mcp` — no auth, 58 tools)

Private MCP (`/mcp/exchange` — OAuth2, 400+ tools)

Info (`/mcp/info` — 32 tools, no auth)

Open Info (`/mcp/open/info` — 7 tools, no auth)

News (`/mcp/news` — 18 tools, no auth)