deBridge

@debridge-finance

2 months ago

A cross-chain bridge and swap toolkit for AI agents — find optimal routes, compare fees, and build transactions across 30+ blockchain networks via the deBridge protocol. Enables AI agents to find optimal cross-chain swap and bridge routes, compare fees, and build transactions across 28 supported networks: Ethereum, Solana, BNB Chain, Polygon, Arbitrum, Optimism, Base, Avalanche, Linea, Sonic, Berachain, Abstract, Mantle, Story, HyperEVM, Tron, Flow, Gnosis, Cronos, Neon, Zilliqa, Sei, Injective, Bob, Sophon, Plasma, Monad, and Megaeth.

Overview Tools Comments

Overview

deBridge MCP Server

A Model Context Protocol (MCP) server for the deBridge protocol — enabling AI agents to find optimal cross-chain and same-chain swap routes, check fees and conditions, and initiate trades across major blockchain networks.

https://github.com/user-attachments/assets/8ebe88ff-db3c-455e-9efb-50389e4bf5bd

Transport Modes

The deBridge MCP server supports two transport modes for local deployment:

stdio (default) - Requires Node.js/npm. For local agent frameworks and CLI tools via standard input/output
HTTP streaming - Requires Docker OR Node.js/npm. For containerized deployments and web-based agents

Setup

Quick Start (npx)

Run directly without installation:

npx -y @debridge-finance/debridge-mcp@latest

Installation from Source

Clone and build:

git clone https://github.com/debridge-finance/debridge-mcp.git
cd debridge-mcp
npm install
npm run build

Running the Server

stdio mode (default):

npx -y @debridge-finance/debridge-mcp@latest
# or from a cloned repo
npm start

HTTP mode:

MCP_TRANSPORT=http npx -y @debridge-finance/debridge-mcp@latest
# or from a cloned repo
npm run start:http

# Custom port
MCP_TRANSPORT=http PORT=3001 npx -y @debridge-finance/debridge-mcp@latest

Docker HTTP mode:

docker build -t debridge-mcp .
docker run -p 3000:3000 debridge-mcp

Configuration for Agent Frameworks

stdio configuration (for local agents):

"debridge": {
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
}

Streamable HTTP:

"debridge": {
  "type": "streamable-http",
  "url": "http://localhost:3001/mcp"
}

Claude Code (CLI & IDE plugins)

Add the MCP server:

claude mcp add debridge npx -- -y @debridge-finance/debridge-mcp@latest
# OR
claude mcp add debridge --transport http http://127.0.0.1:3000/mcp

Verify the connection:

claude mcp list

Cursor

Use Cursor Deeplink:

OR install from Cursor Directory

OR add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "debridge": {
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  }
}

OpenClaw (via mcp-adapter plugin)

Install the mcp-adapter plugin:

openclaw plugins install mcp-adapter

Add to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "mcp-adapter": {
        "enabled": true,
        "config": {
          "servers": [
            {
              "name": "debridge",
              "transport": "stdio",
              "command": "npx",
              "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
            }
          ]
        }
      }
    }
  }
}

Add "mcp-adapter" to your sandbox allowlist and restart:

openclaw gateway restart

Verify the connection:

openclaw plugins list

GitHub Copilot (VS Code Chat)

Add to .vscode/mcp.json in your workspace:

{
  "mcpServers": {
    "debridge": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  }
}

Claude Web & Desktop Apps

Not supported until Streamable HTTP is implemented.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "debridge": {
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  }
}

Cline

Open Cline settings in VS Code, go to MCP Servers, click "Edit MCP Settings" and add:

{
  "mcpServers": {
    "debridge": {
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  }
}

Continue

Add to ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "debridge",
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  ]
}

Zed

Add to your Zed settings (~/.config/zed/settings.json):

{
  "context_servers": {
    "debridge": {
      "command": {
        "path": "npx",
        "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
      }
    }
  }
}

OpenClaw

Add to your OpenClaw config (~/.openclaw/mcp.json):

{
  "mcpServers": {
    "debridge": {
      "command": "npx",
      "args": ["-y", "@debridge-finance/debridge-mcp@latest"]
    }
  }
}

Development

# Run in dev mode (no build needed)
npm run dev

# Test with MCP Inspector
npm run inspect

# Run tests
npm test

License

Try in Playground

Server Config

{
  "mcpServers": {
    "deBridge": {
      "command": "npx",
      "args": [
        "@debridge-finance/debridge-mcp@latest"
      ]
    }
  }
}

Build with ShipAny.