Debridge MCP

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

Use Cursor Deeplink:

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