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"
}

---

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"]
}

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