io.github.debridge-finance/debridge-mcp

Install

Config snippet generator goes here (5 client tabs)

README

# deBridge MCP Server

[![npm version](https://img.shields.io/npm/v/@debridge-finance/debridge-mcp?logo=npm&logoColor=white)](https://www.npmjs.com/package/@debridge-finance/debridge-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-8A2BE2?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJ3aGl0ZSI+PHBhdGggZD0iTTEyIDJMMiA3djEwbDEwIDUgMTAtNVY3TDEyIDJ6Ii8+PC9zdmc+)](https://registry.modelcontextprotocol.io/?q=io.github.debridge-finance%2Fdebridge-mcp)
[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![GitHub Stars](https://img.shields.io/github/stars/debridge-finance/debridge-mcp?style=flat&logo=github)](https://github.com/debridge-finance/debridge-mcp)
[![GitHub Issues](https://img.shields.io/github/issues/debridge-finance/debridge-mcp?logo=github)](https://github.com/debridge-finance/debridge-mcp/issues)
[![GitHub Last Commit](https://img.shields.io/github/last-commit/debridge-finance/debridge-mcp?logo=github)](https://github.com/debridge-finance/debridge-mcp/commits/main)

A Model Context Protocol (MCP) server for the [deBridge](https://debridge.com) 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:

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

### Installation from Source

Clone and build:

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

### Running the Server

**stdio mode** (default):
```bash
npx -y @debridge-finance/debridge-mcp@latest
# or from a cloned repo
npm start
```

**HTTP mode**:
```bash
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**:
```bash
docker build -t debridge-mcp .
docker run -p 3000:3000 debridge-mcp
```

### Configuration for Agent Frameworks

**stdio configuration** (for local agents):

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

**Streamable HTTP**:

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


<details>
<summary>Claude Code (CLI & IDE plugins)</summary>

Add the MCP server:

```bash
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:

```bash
claude mcp list
```

</details>

<details>
<summary>Cursor</summary>

Use Cursor Deeplink: [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=debridge&config=eyJjb21tYW5kIjoibnB4IC15IEBkZWJyaWRnZS1maW5hbmNlL2RlYnJpZGdlLW1jcEBsYXRlc3QifQ%3D%3D)

OR install from [Cursor Directory](https://cursor.directory/mcp/debridge)

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

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

</details>


<details>
<summary>OpenClaw (via mcp-adapter plugin)</summary>

Install the [mcp-adapter](https://github.com/androidStern-personal/openclaw-mcp-adapter) plugin:
```bash
openclaw plugins install mcp-adapter
```

Add to `~/.openclaw/openclaw.json`:
```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:
```bash
openclaw gateway restart
```

Verify the connection:
```bash
openclaw plugins list
```

</details>

<details>
<summary>GitHub Copilot (VS Code Chat)</summary>

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

```json
{
  "mcpServers": {
    "debridge": {
      "type