# deBridge MCP
[](https://agents.debridge.com/mcp)
[](https://agents.debridge.com/llms.txt)
[](https://github.com/debridge-finance/debridge-skills)
[](https://www.npmjs.com/package/@debridge-finance/debridge-mcp)
[](https://registry.modelcontextprotocol.io/?q=io.github.debridge-finance%2Fdebridge-mcp)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org)
[](https://github.com/debridge-finance/debridge-mcp)
[deBridge](https://debridge.com) 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](https://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](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#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](https://agents.debridge.com/llms.txt) overview. Tools and skills are maintained in the [debridge-finance/debridge-skills](https://github.com/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](https://github.com/androidStern-personal/openclaw-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: [](https://cursor.com/en-US/install-mcp?name=debridge&config=eyJjb21tYW5kIjoibnB4IC15IEBkZWJyaWRnZS1maW5hbmNlL2RlYnJpZGdlLW1jcEBsYXRlc3QifQ%3D%3D)
OR install from [Cursor Directory](https://cursor.directory/mcp/debridge)
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
```
## Links
[](https://agents.debridge.com/mcp)
[](https://agents.debridge.com)
[](https://agents.debridge.com/llms.txt)
[](https://github.com/debridge-finance/debridge-skills)
[](https://www.npmjs.com/package/@debridge-finance/debridge-mcp)
[](https://registry.modelcontextprotocol.io/?q=io.github.debridge-finance%2Fdebridge-mcp)
## License
[MIT](LICENSE), Copyright 2026 deBridge