deBridge MCP

deBridge MCP integration for AI agents — cross-chain and same-chain swaps, fee estimation, and trade execution across major blockchain networks.

The hosted MCP endpoint is available at agents.debridge.com. This npm package is a thin proxy client for agents that require a local stdio or HTTP process.

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

Connecting to deBridge MCP

Recommended: Direct connection (Streamable HTTP)

Connect your agent directly to the hosted endpoint — no installation, no local process:

https://agents.debridge.com/mcp

This is a Streamable HTTP MCP endpoint. It exposes tools (`get_instructions`, `search_tokens`, `get_supported_chains`, `create_tx`, `transaction_same_chain_swap`), workflow skills via MCP resources, and an llms.txt overview. Tools and skills are maintained in the debridge-finance/debridge-skills repository.

Generic Streamable HTTP configuration:

"debridge": {
  "type": "streamable-http",
  "url": "https://agents.debridge.com/mcp"
}

Claude Code (CLI & IDE plugins)

claude mcp add debridge --transport http https://agents.debridge.com/mcp

Verify:

claude mcp list

Claude Web & Desktop Apps

Add as a remote MCP server with the URL `https://agents.debridge.com/mcp`.

Cursor

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

{
  "mcpServers": {
    "debridge": {
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

GitHub Copilot (VS Code Chat)

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

{
  "mcpServers": {
    "debridge": {
      "type": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "debridge": {
      "type": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

Cline

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

{
  "mcpServers": {
    "debridge": {
      "type": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

Continue

Add to `~/.continue/config.json`:

{
  "mcpServers": [
    {
      "name": "debridge",
      "transport": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  ]
}

Zed

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

{
  "context_servers": {
    "debridge": {
      "transport": "streamable-http",
      "url": "https://agents.debridge.com/mcp"
    }
  }
}

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": "streamable-http",
              "url": "https://agents.debridge.com/mcp"
            }
          ]
        }
      }
    }
  }
}

Alternative: Run a local proxy

Some agent frameworks only support stdio transport and cannot connect to a remote HTTP endpoint directly. This npm package bridges that gap — it runs a local MCP process that transparently proxies all requests to `https://agents.debridge.com/mcp`.

Tools and resources are not implemented locally. They are dynamically discovered from the upstream endpoint at startup (stdio) or forwarded per-request (HTTP), so any changes to the hosted MCPd are reflected automatically without updating the package.

How the proxy works

• Stdio mode (default): Opens a long-lived MCP client connection to the upstream MCPd via `StreamableHTTPClientTransport`. Creates a local `Server` with `StdioServerTransport` that mirrors the upstream capabilities and forwards `tools/list`, `tools/call`, `resources/list`, `resources/read`, and `resources/templates/list` to the upstream.

• HTTP mode (`MCP_TRANSPORT=http`): Transparent HTTP reverse proxy via Express. Forwards raw JSON-RPC requests and SSE response streams to the upstream MCPd, passing through `Mcp-Session-Id` headers for session continuity.

npx (stdio)

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

stdio configuration:

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

Claude Code (CLI & IDE plugins)

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

Cursor

OR install from Cursor Directory

OR add to `.cursor/mcp.json`:

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

Docker (HTTP proxy)

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

Then connect your agent to `http://localhost:3000/mcp` using the Streamable HTTP configs above.

Environment Variables

Development

# Install dependencies
npm install

# Run in dev mode (stdio proxy)
npm run dev

# Run in dev mode (HTTP proxy)
npm run dev:http

# Test with MCP Inspector
npm run inspect

# Run tests
npm test

Links

License

MIT, Copyright 2026 deBridge