Symbiosis MCP Server
Our MCP server allows AI agents to perform any-to-any token swaps across 50+ blockchains through a standardized Model Context Protocol interface, while maintaining full decentralization.
Symbiosis MCP Server exposes cross-chain and same-chain swaps, token search across 6000+ tokens, real-time quotes, transaction signing and broadcasting — all as MCP tools ready to use in any compatible AI client.
Get Started
Quickly connect Symbiosis MCP Server to your AI tool with these three simple steps:
Step 1
Install the server
Clone the repository and run npm install && npm run build, pull the Docker image from Docker Hub, or skip installation and connect directly to the hosted instance at mcp.symbiosis.finance/mcp
Step 2
Configure your environment
Copy .env.example to .env. Add your PRIVATE_KEY to enable swap execution. Without it, the server runs in read-only mode: token search, quotes, calldata, and swap URLs are still available.
Step 3
Connect to your AI client
Add Symbiosis MCP Server to Claude, Cursor, Windsurf, VS Code, Cline, Continue, Zed, or any MCP-compatible client. Your agents are ready to swap.
Features Available via MCP
All tools work without a private key in read-only mode. Add PRIVATE_KEY to unlock swap execution.
Swaps & Quotes
Search 6000+ tokens by name, symbol, or contract address across all supported chains
Get a swap quote — expected output, fees, and estimated time
Generate a pre-filled Symbiosis app URL for the user to execute in their browser
Execution*
Build transaction calldata with approve check and gas params
Sign and broadcast in one step
All-in-one: calldata + approve + sign + broadcast in a single call
*(requires PRIVATE_KEY)
Tracking & Balances
Check cross-chain swap status by tx hash
Check token balances across all EVM chains
Get validated RPC endpoints for any chain, sorted by latency
Why use Symbiosis MCP?
Any-to-any swaps
Swap any token for any other token — ERC-20, SPL, TRC-20, meme tokens, new tokens — on the same chain or across different chains.
50+ blockchains
One MCP server covers Ethereum, Arbitrum, BNB Chain, Solana, Bitcoin, TON, Tron and 40+ more networks.
No installation required
Connect directly to the hosted instance at mcp.symbiosis.finance/mcp — no setup, no private key needed to get started.
Flexible execution modes
Read-only mode for quotes and calldata. Full mode with PRIVATE_KEY for signing and broadcasting — including a single all-in-one call.
Works with your AI tools
Native support for Claude, Cursor, Windsurf, VS Code, Cline, Continue, Zed and any other MCP-compatible client.
Human-readable amounts
No wei, no lamports, no satoshis. Pass "1.5" and get "1.49 USDC" back — the server handles all decimal conversions automatically.