Tools Reference
The Xplore MCP Server exposes the following tools to AI agents. Each tool is callable via the Model Context Protocol.
get_supported_chains
List all blockchain networks supported by Xplore for cross-chain and same-chain swaps.
Parameters: None
Returns: List of supported chains with chain IDs, names, native tokens, and logos.
Example usage: Resolve user-friendly chain names (e.g., "Ethereum", "Solana") to numeric chain IDs needed by other tools.
search_tokens
Search for tokens by name, symbol, or contract address. Use this to resolve human-readable token names to contract addresses before creating swap orders.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Token name, symbol, or contract address. Examples: USDC, ethereum, 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 |
chainId | string | No | Filter by chain ID. Examples: 1 (Ethereum), 42161 (Arbitrum), 7565164 (Solana) |
limit | number | No | Max results to return. Default: 10, max: 100 |
Returns: Array of matching tokens with address, symbol, name, decimals, and chain information.
get_quote
Get a quote for a token swap (same-chain or cross-chain). Returns routing information, estimated output, fees, and transaction data.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
fromChain | string | Yes | Source chain ID. Examples: 1 (Ethereum), 56 (BNB Chain), 137 (Polygon), 7565164 (Solana) |
toChain | string | Yes | Destination chain ID. Same as fromChain for same-chain swaps |
fromToken | string | Yes | Source token address. Use 0x0000000000000000000000000000000000000000 for native tokens (ETH, BNB, etc.) |
toToken | string | Yes | Destination token address |
fromAmount | string | Yes | Amount in smallest units (wei, lamports). Example: 1000000000000000000 for 1 ETH (18 decimals), 1000000 for 1 USDC (6 decimals) |
fromAddress | string | Yes | Sender wallet address |
toAddress | string | Yes | Recipient wallet address |
slippage | number | No | Slippage tolerance as a decimal. Default: 0.03 (3%) |
Returns: Quote with routing information, estimated output amount, fees, and transaction data.
Use search_tokens first to resolve token names to addresses, and get_supported_chains to get the correct chain IDs.
create_transaction
Build a swap transaction with full route details. Fetches advanced routes and populates each step with transaction data ready for signing.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
fromChain | string | Yes | Source chain ID |
toChain | string | Yes | Destination chain ID. Same as fromChain for same-chain swaps |
fromToken | string | Yes | Source token address. Use 0x0000000000000000000000000000000000000000 for native tokens |
toToken | string | Yes | Destination token address |
fromAmount | string | Yes | Amount in smallest units (wei, lamports) |
fromAddress | string | Yes | Sender wallet address |
toAddress | string | Yes | Recipient wallet address |
slippage | number | No | Slippage tolerance as a decimal. Default: 0.03 (3%) |
Returns: Complete route object with all steps populated with transaction data ready for signing.
Use get_quote first for a quick estimate, then create_transaction when the user is ready to execute the swap.
get_dapp_url
Generate a pre-filled Router Protocol App URL that redirects the user to complete a swap in the browser.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
fromChain | string | Yes | Source chain ID |
toChain | string | Yes | Destination chain ID |
fromToken | string | No | Token address on the source chain. Leave empty for the chain's native token |
toToken | string | No | Token address on the destination chain. Leave empty for the chain's native token |
amount | string | Yes | Human-readable amount to swap (e.g., 1.5, 100). NOT in smallest units |
address | string | No | Recipient wallet address. Use when the recipient differs from the sender's connected wallet |
Returns: Complete Router Protocol App URL with swap parameters encoded as query parameters.
The amount parameter uses human-readable decimals (e.g., 1.5 for 1.5 ETH), unlike get_quote and create_transaction which use smallest units (wei/lamports).
check_transaction_status
Check the status of a cross-chain transaction by its transaction hash.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
txHash | string | Yes | Transaction hash to check status for |
Returns: Transaction status (PENDING, DONE, or FAILED) with sending/receiving transaction details and the bridge/tool used.
get_tools
List available bridges and DEX exchanges that can be used for routing swaps.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
chains | string | No | Comma-separated chain IDs to filter by. Example: 1,42161. Omit for all chains |
Returns: List of available bridges and DEX exchanges with their supported chains.
get_connections
List available connections between two chains, including supported tokens and routing tools. Use this to discover what swap routes are available before requesting a quote.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
fromChain | string | No | Source chain ID to filter by. Example: 1 (Ethereum) |
toChain | string | No | Destination chain ID to filter by. Example: 42161 (Arbitrum) |
Returns: List of available connections between chains with supported tokens and routing tools.
get_instructions
Returns the built-in workflow guide covering the recommended swap workflow, tool descriptions, and tips.
Parameters: None
Returns: The complete workflow guide text.