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.

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.

  • Ethereum (ETH)

    Ethereum

  • Solana (SOL)

    Solana

  • BNB Chain (BNB)

    BNB

  • TRON DAO logo

    TRON

  • Base

    Base

  • Arbitrum (ARB)

    Arbitrum

  • TON (The Open Network)

    TON

  • Bitcoin (BTC)

    Bitcoin

  • Dogecoin (DOGE)

    Dogecoin

  • Bitcoin Cash (BCH)

    Bitcoin Cash

  • Litecoin (LTC)

    Litecoin

  • Monero (XMR)

    Monero

  • XRP Ledger (XRP)

    XRP Ledger

  • Zcash (ZEC)

    Zcash

  • Hyperliquid (HYPE)

    Hyperliquid

  • Lighter

    Lighter

  • Optimism (OP)

    Optimism

  • Polygon (POL)

    Polygon

  • Robinhood Chain

    Robinhood

  • Avalanche (AVAX)

    Avalanche

  • Ethereum (ETH)

    Ethereum

  • Solana (SOL)

    Solana

  • BNB Chain (BNB)

    BNB

  • TRON DAO logo

    TRON

  • Base

    Base

  • Arbitrum (ARB)

    Arbitrum

  • TON (The Open Network)

    TON

  • Bitcoin (BTC)

    Bitcoin

  • Dogecoin (DOGE)

    Dogecoin

  • Bitcoin Cash (BCH)

    Bitcoin Cash

  • Litecoin (LTC)

    Litecoin

  • Monero (XMR)

    Monero

  • XRP Ledger (XRP)

    XRP Ledger

  • Zcash (ZEC)

    Zcash

  • Hyperliquid (HYPE)

    Hyperliquid

  • Lighter

    Lighter

  • Optimism (OP)

    Optimism

  • Polygon (POL)

    Polygon

  • Robinhood Chain

    Robinhood

  • Avalanche (AVAX)

    Avalanche

  • Bitcoin (BTC)

    Bitcoin

  • TON (The Open Network)

    TON

  • Arbitrum (ARB)

    Arbitrum

  • Base

    Base

  • TRON DAO logo

    Tron

  • BNB Chain (BNB)

    BNB

  • Solana (SOL)

    Solana

  • Ethereum (ETH)

    Ethereum

Get started with these three simple steps

Connect to the MCP Server

Clone the repository and run and pull the Docker image from Docker Hub

npm install && npm run build

npm install && npm run build

Or skip installation and connect directly to the hosted instance at

Configure your environment

Copy

.env.example to .env.

.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.

PRIVATE_KEY=your_private_key_here

PRIVATE_KEY=your_private_key_here

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

Features available via MCP

All tools work without a private key in read-only mode.
Add PRIVATE_KEY to unlock swap execution.

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?

coin icon

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.

gear icon

50+ blockchains

One MCP server connects 50+ blockchains, including Ethereum, Arbitrum, BNB Chain, Solana, Bitcoin, TON, Tron, and 40+ more networks

gear icon

50+ blockchains

One MCP server connects 50+ blockchains, including Ethereum, Arbitrum, BNB Chain, Solana, Bitcoin, TON, Tron, and 40+ more networks

vault icon

No installation required

Connect directly to the hosted instance at mcp.symbiosis.finance/mcp โ€” no setup, no private key needed to get started.

vault icon

No installation required

Connect directly to the hosted instance at mcp.symbiosis.finance/mcp โ€” no setup, no private key needed to get started.

flash icon

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.

flash icon

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.

export icon

Works with your AI tools

Native support for Claude, Cursor, Windsurf, VS Code, Cline, Continue, Zed and any other MCP-compatible client.

export icon

Works with your AI tools

Native support for Claude, Cursor, Windsurf, VS Code, Cline, Continue, Zed and any other MCP-compatible client.

code icon

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.

code icon

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.