MCP Server

The WheelX MCP (Model Context Protocol) Server allows AI assistants and LLM-powered applications to interact with the WheelX DeFi platform — getting quotes, tracking orders, estimating gas, and comparing swap routes — all through a standardized protocol.

Built with FastMCP, it exposes 6 tools and 3 resources for AI agents.

What You Can Do

Tools

Tool	Description
get_quote	Get swap/bridge quotes with transaction payload
get_order_status	Check the status of submitted orders
get_supported_chains	List all supported blockchain networks
calculate_token_amount	Convert human-readable amounts to raw token units
estimate_gas_cost	Estimate gas costs for transactions
compare_quotes	Compare quotes with different slippage settings

Resources

Resource URI	Description
wheelx://chains/{chain_id}/tokens	Get popular tokens for a specific chain
wheelx://status	Check WheelX service status and availability
wheelx://docs/usage	Usage documentation

Supported Chains

Ethereum (1), Optimism (10), BNB Smart Chain (56), Polygon (137), Arbitrum One (42161), Base (8453), Avalanche C-Chain (43114)

Install & Run

# Clone the SDK repo
git clone https://github.com/wheelx-fi/wheelx-sdk
cd wheelx-sdk/python

# Install dependencies
pip install fastmcp requests

# Run the server
python mcp_server.py

Configuration

Set via environment variables:

Variable	Default	Description
WHEELX_BASE_URL	https://api.wheelx.fi	API base URL (planned)
WHEELX_TIMEOUT	30	Request timeout in seconds (planned)

Environment variable support is planned for a future release. Currently the server uses built-in defaults: https://api.wheelx.fi with a 30-second timeout.

Usage Example

# An AI agent calls the get_quote tool:
quote = await get_quote(
from_chain=1,
to_chain=1,
from_token="0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
to_token="0xdAC17F958D2ee523a2206206994597C13D831ec7",
from_address="0x742d35Cc6634C0532925a3b8Dc9F6A7c5D3a7C6a",
to_address="0x742d35Cc6634C0532925a3b8Dc9F6A7c5D3a7C6a",
amount=1000000,
slippage=50
)
# Returns: request_id, amount_out, min_receive, transaction payload, etc.