io.github.debridge-finance/debridge-mcp

Official5 toolsLive

by debridge-finance · TypeScript

deBridge MCP

io.github.debridge-finance/debridge-mcp (deBridge MCP)

This MCP server is named deBridge MCP. It exposes 5 tools via an MCP endpoint at agents.debridge.com/mcp. The provided documentation excerpt also references an llms.txt resource at agents.debridge.com, indicating where further service information can be found.

🛠️ Key Features

Server name: deBridge MCP
5 total tools exposed
MCP endpoint hosted on agents.debridge.com/mcp
Documentation references llms.txt at agents.debridge.com

🚀 Use Cases

Use MCP-compatible agents to interact with the deBridge MCP toolset
Discover integration details via the linked llms.txt location

⚡ Developer Benefits

Known tool count (5) for tooling discovery and integration planning
Stable host for the MCP endpoint: agents.debridge.com/mcp

⚠️ Limitations

No tool names, inputs/outputs, or functionality details are included in the provided excerpt beyond the endpoint and tool count

Captured live from the server via tools/list.

get_instructions

Returns the full guide for the deBridge MCP server. CALL THIS FIRST.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_tokens

Search for tokens by name, symbol, or contract address in the deBridge token database

Parameters4

query	string	required	Token name, symbol, or contract address
chainId	string	optional	Filter by chain ID
name	string	optional	Filter by token name (partial, case-insensitive)
limit	number	optional	Max results (default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token name, symbol, or contract address"
    },
    "chainId": {
      "description": "Filter by chain ID",
      "type": "string"
    },
    "name": {
      "description": "Filter by token name (partial, case-insensitive)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 10)",
      "type": "number"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_supported_chains

List all blockchain networks supported by deBridge for cross-chain swaps

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_tx

Create a cross-chain swap transaction via the deBridge DLN protocol

Parameters12

srcChainId	string	required	Source chain ID
srcChainTokenIn	string	required	Token address on source chain
srcChainTokenInAmount	string	required	Amount in smallest units (wei, lamports)
dstChainId	string	required	Destination chain ID
dstChainTokenOut	string	required	Token address on destination chain
dstChainTokenOutRecipient	string	required	Wallet address on destination chain to receive tokens
srcChainOrderAuthorityAddress	string	required	Address on source chain authorized to manage the order
dstChainOrderAuthorityAddress	string	required	Address on destination chain authorized to manage the order
dstChainTokenOutAmount	string	optional	Output amount or 'auto' for best quote
affiliateFeePercent	number	optional	Affiliate fee percentage
affiliateFeeRecipient	string	optional	Wallet address to receive affiliate fees
prependOperatingExpenses	boolean	optional	Whether to prepend estimated operating expenses to the input amount

Raw schema

{
  "type": "object",
  "properties": {
    "srcChainId": {
      "type": "string",
      "description": "Source chain ID"
    },
    "srcChainTokenIn": {
      "type": "string",
      "description": "Token address on source chain"
    },
    "srcChainTokenInAmount": {
      "type": "string",
      "description": "Amount in smallest units (wei, lamports)"
    },
    "dstChainId": {
      "type": "string",
      "description": "Destination chain ID"
    },
    "dstChainTokenOut": {
      "type": "string",
      "description": "Token address on destination chain"
    },
    "dstChainTokenOutRecipient": {
      "type": "string",
      "description": "Wallet address on destination chain to receive tokens"
    },
    "srcChainOrderAuthorityAddress": {
      "type": "string",
      "description": "Address on source chain authorized to manage the order"
    },
    "dstChainOrderAuthorityAddress": {
      "type": "string",
      "description": "Address on destination chain authorized to manage the order"
    },
    "dstChainTokenOutAmount": {
      "description": "Output amount or 'auto' for best quote",
      "type": "string"
    },
    "affiliateFeePercent": {
      "description": "Affiliate fee percentage",
      "type": "number"
    },
    "affiliateFeeRecipient": {
      "description": "Wallet address to receive affiliate fees",
      "type": "string"
    },
    "prependOperatingExpenses": {
      "description": "Whether to prepend estimated operating expenses to the input amount",
      "type": "boolean"
    }
  },
  "required": [
    "srcChainId",
    "srcChainTokenIn",
    "srcChainTokenInAmount",
    "dstChainId",
    "dstChainTokenOut",
    "dstChainTokenOutRecipient",
    "srcChainOrderAuthorityAddress",
    "dstChainOrderAuthorityAddress"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

transaction_same_chain_swap

Create a same-chain token swap transaction via deBridge

Parameters11

chainId	string	required	Chain ID (native or deBridge internal)
tokenIn	string	required	Input token address
tokenInAmount	string	required	Amount in smallest units
tokenOut	string	required	Output token address
tokenOutRecipient	string	required	Address on the source chain to receive target tokens
slippage	string	optional	Slippage tolerance or 'auto'
tokenOutAmount	string	optional	Expected output amount or 'auto'
affiliateFeePercent	number	optional	Affiliate fee percentage
affiliateFeeRecipient	string	optional	Wallet address to receive affiliate fees
senderAddress	string	optional	Transaction submitter address
srcChainPriorityLevel	string	optional	Priority level: 'normal' or 'aggressive' (default: 'normal')

Raw schema

{
  "type": "object",
  "properties": {
    "chainId": {
      "type": "string",
      "description": "Chain ID (native or deBridge internal)"
    },
    "tokenIn": {
      "type": "string",
      "description": "Input token address"
    },
    "tokenInAmount": {
      "type": "string",
      "description": "Amount in smallest units"
    },
    "tokenOut": {
      "type": "string",
      "description": "Output token address"
    },
    "tokenOutRecipient": {
      "type": "string",
      "description": "Address on the source chain to receive target tokens"
    },
    "slippage": {
      "description": "Slippage tolerance or 'auto'",
      "type": "string"
    },
    "tokenOutAmount": {
      "description": "Expected output amount or 'auto'",
      "type": "string"
    },
    "affiliateFeePercent": {
      "description": "Affiliate fee percentage",
      "type": "number"
    },
    "affiliateFeeRecipient": {
      "description": "Wallet address to receive affiliate fees",
      "type": "string"
    },
    "senderAddress": {
      "description": "Transaction submitter address",
      "type": "string"
    },
    "srcChainPriorityLevel": {
      "description": "Priority level: 'normal' or 'aggressive' (default: 'normal')",
      "type": "string"
    }
  },
  "required": [
    "chainId",
    "tokenIn",
    "tokenInAmount",
    "tokenOut",
    "tokenOutRecipient"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md11 KBView on GitHub

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:

code

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:

json

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

Claude Code (CLI & IDE plugins)

bash

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

Verify:

bash

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:

json

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

GitHub Copilot (VS Code Chat)

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

json

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

Windsurf

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

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:

json

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

Continue

Add to ~/.continue/config.json:

json

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

Zed

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

json

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

OpenClaw (via mcp-adapter plugin)

Install the mcp-adapter plugin:

bash

openclaw plugins install mcp-adapter

Add to ~/.openclaw/openclaw.json:

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)

bash

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

stdio configuration:

json

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

Claude Code (CLI & IDE plugins)

bash

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:

json

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

Docker (HTTP proxy)

bash

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

bash

# 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

License

Install

Tools (5)

get_instructionssearch_tokensget_supported_chainscreate_txtransaction_same_chain_swap

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

io.github.debridge-finance/debridge-mcp

io.github.debridge-finance/debridge-mcp (deBridge MCP)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_instructions

search_tokens

get_supported_chains

create_tx

transaction_same_chain_swap

deBridge MCP

Connecting to deBridge MCP

Recommended: Direct connection (Streamable HTTP)

Alternative: Run a local proxy

How the proxy works

npx (stdio)

Docker (HTTP proxy)

Environment Variables

Development

Links

License

Install

Related servers