Summary
Connects AI agents to deBridge's cross-chain infrastructure for token swaps and transfers across major blockchains. Exposes tools for searching tokens, checking supported chains, estimating fees, and creating swap transactions, both cross-chain and same-chain. The hosted endpoint at agents.debridge.com runs over streamable HTTP, so you can connect directly without installing anything local. The npm package is a thin proxy for agents that only speak stdio. Built for agents that need to move tokens between chains or execute trades as part of larger workflows. Tools and workflow skills are maintained in the debridge-skills repository and pulled dynamically, so you get updates without reinstalling.
Install to Claude Code
verifiedclaude mcp add --transport http debridge-mcp https://agents.debridge.com/mcpRun in your terminal. Add --scope user to make it available in every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Verified live against the running server on Jun 10, 2026.
verified live5 tools
get_instructionsReturns the full guide for the deBridge MCP server. CALL THIS FIRST.
Returns the full guide for the deBridge MCP server. CALL THIS FIRST.
No parameters — call it with no arguments.
search_tokensSearch for tokens by name, symbol, or contract address in the deBridge token database4 params
Search for tokens by name, symbol, or contract address in the deBridge token database
Parameters* required
namestringFilter by token name (partial, case-insensitive)
limitnumberMax results (default 10)
query*stringToken name, symbol, or contract address
chainIdstringFilter by chain ID
get_supported_chainsList all blockchain networks supported by deBridge for cross-chain swaps
List all blockchain networks supported by deBridge for cross-chain swaps
No parameters — call it with no arguments.
create_txCreate a cross-chain swap transaction via the deBridge DLN protocol12 params
Create a cross-chain swap transaction via the deBridge DLN protocol
Parameters* required
dstChainId*stringDestination chain ID
srcChainId*stringSource chain ID
srcChainTokenIn*stringToken address on source chain
dstChainTokenOut*stringToken address on destination chain
affiliateFeePercentnumberAffiliate fee percentage
affiliateFeeRecipientstringWallet address to receive affiliate fees
srcChainTokenInAmount*stringAmount in smallest units (wei, lamports)
dstChainTokenOutAmountstringOutput amount or 'auto' for best quote
prependOperatingExpensesbooleanWhether to prepend estimated operating expenses to the input amount
dstChainTokenOutRecipient*stringWallet address on destination chain to receive tokens
dstChainOrderAuthorityAddress*stringAddress on destination chain authorized to manage the order
srcChainOrderAuthorityAddress*stringAddress on source chain authorized to manage the order
transaction_same_chain_swapCreate a same-chain token swap transaction via deBridge11 params
Create a same-chain token swap transaction via deBridge
Parameters* required
chainId*stringChain ID (native or deBridge internal)
tokenIn*stringInput token address
slippagestringSlippage tolerance or 'auto'
tokenOut*stringOutput token address
senderAddressstringTransaction submitter address
tokenInAmount*stringAmount in smallest units
tokenOutAmountstringExpected output amount or 'auto'
tokenOutRecipient*stringAddress on the source chain to receive target tokens
affiliateFeePercentnumberAffiliate fee percentage
affiliateFeeRecipientstringWallet address to receive affiliate fees
srcChainPriorityLevelstringPriority level: 'normal' or 'aggressive' (default: 'normal')
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 localServerwithStdioServerTransportthat mirrors the upstream capabilities and forwardstools/list,tools/call,resources/list,resources/read, andresources/templates/listto 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 throughMcp-Session-Idheaders 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
# 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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
Package@debridge-finance/debridge-mcp
TransportSTDIO, HTTP
Resources1
Tools verifiedJun 10, 2026
UpdatedApr 1, 2026