# Debridge MCP

> Debridge MCP is an open-source MCP server for crypto and web3. Hosted MCP server for cross-chain and same-chain token swaps via deBridge. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, vscode, Web, self-hosted
- **Repository:** https://github.com/debridge-finance/debridge-mcp
- **MCP Registry name:** io.github.debridge-finance/debridge-mcp
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-18

## About

The README describes deBridge's MCP endpoint as a way for AI agents to estimate fees and execute swaps between tokens, both across chains and within a single chain. Agents reach it through a hosted Streamable HTTP address, so no local install is needed for most clients.

The server exposes a small set of tools, including token search, supported-chain lookup, transaction creation and a same-chain swap call, plus workflow skills delivered as MCP resources. The README credits the separate debridge-skills repository for maintaining those tools and skills.

For clients that only speak stdio, the MIT-licensed npm package runs a local proxy that forwards requests to the hosted endpoint, and a Docker image offers the same proxy over HTTP. It suits developers wiring swap capability into Claude, Cursor, VS Code, Cline and similar assistants.

## Features

- **Cross-chain swaps:** Lets an agent quote and execute token transfers that move between different blockchain networks.
- **Same-chain swaps:** Provides a tool for exchanging tokens on a single network.
- **Token and chain lookup:** Includes tools to search tokens and list the chains that are supported.
- **Local stdio proxy:** An npm package and Docker image relay requests to the hosted endpoint for clients that cannot connect over HTTP.
- **Configurable proxy target:** Environment variables set the upstream URL, transport mode, port and host of the local proxy.

## Good for

- Letting an AI assistant quote a cross-chain token transfer before a user confirms it
- Searching for token addresses and supported chains from inside an agent workflow
- Adding swap tooling to a Cursor or VS Code coding assistant
- Running a local HTTP proxy for agent frameworks that only support stdio

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agents.debridge.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "debridge-mcp": {
      "serverUrl": "https://agents.debridge.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_instructions`: Listed in the README as an MCP tool on the hosted endpoint.
- `search_tokens`: Listed in the README as an MCP tool on the hosted endpoint.
- `get_supported_chains`: Listed in the README as an MCP tool on the hosted endpoint.
- `create_tx`: Listed in the README as an MCP tool on the hosted endpoint.
- `transaction_same_chain_swap`: Listed in the README as an MCP tool on the hosted endpoint.

## FAQ

### Do I need to install anything to use it?

No. The README recommends connecting directly to the hosted Streamable HTTP endpoint, with no installation or local process.

### What is the npm package for?

It is a thin proxy client for agents that need a local stdio or HTTP process. It forwards requests to the hosted endpoint rather than implementing tools itself.

### What license is it under?

The repository is licensed under MIT, copyright 2026 deBridge.

### Is Debridge MCP free?

Yes. Debridge MCP is open source, so you can use and self-host it for free.

### How do I add Debridge MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http debridge-mcp https://agents.debridge.com/mcp

### What are the best alternatives to Debridge MCP?

The closest alternatives to Debridge MCP are Universal Blockchain MCP, Chainlist and WarpPay402 MCP Gateway.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Universal Blockchain MCP](https://ai-powered.com/mcp/universal-blockchain-mcp): Universal Blockchain MCP is an open-source MCP server for finance and payments.
- [Chainlist](https://ai-powered.com/mcp/chainlist): Chainlist is a freemium MCP server for crypto and web3.
- [WarpPay402 MCP Gateway](https://ai-powered.com/mcp/warppay402-mcp-gateway): WarpPay402 MCP Gateway is a paid MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/debridge-mcp
