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 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
| Variable | Default | Description |
|---|
REMOTE_MCP_URL | https://agents.debridge.com/mcp | Remote MCP endpoint to proxy to |
MCP_TRANSPORT | stdio | Transport mode: stdio or http |
PORT | 3000 | HTTP listen port (HTTP mode only) |
HOST | 0.0.0.0 | HTTP listen host (HTTP mode only) |
Development
npm install
npm run dev
npm run dev:http
npm run inspect
npm test
Links

License
MIT, Copyright 2026 deBridge