deBridge MCP Server

A Model Context Protocol (MCP) server for the deBridge protocol — enabling AI agents to find optimal cross-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

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.

Cursor

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

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

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

deBridge MCP Server