{
"markdown": "# deBridge MCP\n\n[](https://agents.debridge.com/mcp)\n[](https://agents.debridge.com/llms.txt)\n[](https://github.com/debridge-finance/debridge-skills)\n[](https://www.npmjs.com/package/@debridge-finance/debridge-mcp)\n[](https://registry.modelcontextprotocol.io/?q=io.github.debridge-finance%2Fdebridge-mcp)\n[](https://opensource.org/licenses/MIT)\n[](https://www.typescriptlang.org/)\n[](https://nodejs.org)\n[](https://github.com/debridge-finance/debridge-mcp)\n\n[deBridge](https://debridge.com) MCP integration for AI agents — cross-chain and same-chain swaps, fee estimation, and trade execution across major blockchain networks.\n\nThe 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.\n\nhttps://github.com/user-attachments/assets/8ebe88ff-db3c-455e-9efb-50389e4bf5bd\n\n## Connecting to deBridge MCP\n\n### Recommended: Direct connection (Streamable HTTP)\n\nConnect your agent directly to the hosted endpoint — no installation, no local process:\n\n```\nhttps://agents.debridge.com/mcp\n```\n\nThis 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.\n\n**Generic Streamable HTTP configuration:**\n\n```json\n\"debridge\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n}\n```\n\n\nClaude Code (CLI & IDE plugins)
\n\n```bash\nclaude mcp add debridge --transport http https://agents.debridge.com/mcp\n```\n\nVerify:\n\n```bash\nclaude mcp list\n```\n\n \n\n\nClaude Web & Desktop Apps
\n\nAdd as a remote MCP server with the URL `https://agents.debridge.com/mcp`.\n\n \n\n\nCursor
\n\nAdd to `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:\n\n```json\n{\n \"mcpServers\": {\n \"debridge\": {\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n }\n}\n```\n\n \n\n\nGitHub Copilot (VS Code Chat)
\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n```json\n{\n \"mcpServers\": {\n \"debridge\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n }\n}\n```\n\n \n\n\nWindsurf
\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"debridge\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n }\n}\n```\n\n \n\n\nCline
\n\nOpen Cline settings in VS Code, go to MCP Servers, click \"Edit MCP Settings\" and add:\n\n```json\n{\n \"mcpServers\": {\n \"debridge\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n }\n}\n```\n\n \n\n\nContinue
\n\nAdd to `~/.continue/config.json`:\n\n```json\n{\n \"mcpServers\": [\n {\n \"name\": \"debridge\",\n \"transport\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n ]\n}\n```\n\n \n\n\nZed
\n\nAdd to your Zed settings (`~/.config/zed/settings.json`):\n\n```json\n{\n \"context_servers\": {\n \"debridge\": {\n \"transport\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n }\n}\n```\n\n \n\n\nOpenClaw (via mcp-adapter plugin)
\n\nInstall the [mcp-adapter](https://github.com/androidStern-personal/openclaw-mcp-adapter) plugin:\n```bash\nopenclaw plugins install mcp-adapter\n```\n\nAdd to `~/.openclaw/openclaw.json`:\n```json\n{\n \"plugins\": {\n \"entries\": {\n \"mcp-adapter\": {\n \"enabled\": true,\n \"config\": {\n \"servers\": [\n {\n \"name\": \"debridge\",\n \"transport\": \"streamable-http\",\n \"url\": \"https://agents.debridge.com/mcp\"\n }\n ]\n }\n }\n }\n }\n}\n```\n\n \n\n---\n\n### Alternative: Run a local proxy\n\nSome 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`.\n\nTools 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.\n\n#### How the proxy works\n\n- **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.\n\n- **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.\n\n#### npx (stdio)\n\n```bash\nnpx -y @debridge-finance/debridge-mcp@latest\n```\n\n**stdio configuration:**\n\n```json\n\"debridge\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@debridge-finance/debridge-mcp@latest\"]\n}\n```\n\n\nClaude Code (CLI & IDE plugins)
\n\n```bash\nclaude mcp add debridge npx -- -y @debridge-finance/debridge-mcp@latest\n```\n\n \n\n\nCursor
\n\nUse Cursor Deeplink: [](https://cursor.com/en-US/install-mcp?name=debridge&config=eyJjb21tYW5kIjoibnB4IC15IEBkZWJyaWRnZS1maW5hbmNlL2RlYnJpZGdlLW1jcEBsYXRlc3QifQ%3D%3D)\n\nOR install from [Cursor Directory](https://cursor.directory/mcp/debridge)\n\nOR add to `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"debridge\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@debridge-finance/debridge-mcp@latest\"]\n }\n }\n}\n```\n\n \n\n#### Docker (HTTP proxy)\n\n```bash\ndocker build -t debridge-mcp .\ndocker run -p 3000:3000 debridge-mcp\n```\n\nThen connect your agent to `http://localhost:3000/mcp` using the Streamable HTTP configs above.\n\n#### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `REMOTE_MCP_URL` | `https://agents.debridge.com/mcp` | Remote MCP endpoint to proxy to |\n| `MCP_TRANSPORT` | `stdio` | Transport mode: `stdio` or `http` |\n| `PORT` | `3000` | HTTP listen port (HTTP mode only) |\n| `HOST` | `0.0.0.0` | HTTP listen host (HTTP mode only) |\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in dev mode (stdio proxy)\nnpm run dev\n\n# Run in dev mode (HTTP proxy)\nnpm run dev:http\n\n# Test with MCP Inspector\nnpm run inspect\n\n# Run tests\nnpm test\n```\n\n## Links\n\n[](https://agents.debridge.com/mcp)\n[](https://agents.debridge.com)\n[](https://agents.debridge.com/llms.txt)\n[](https://github.com/debridge-finance/debridge-skills)\n[](https://www.npmjs.com/package/@debridge-finance/debridge-mcp)\n[](https://registry.modelcontextprotocol.io/?q=io.github.debridge-finance%2Fdebridge-mcp)\n\n## License\n\n[MIT](LICENSE), Copyright 2026 deBridge\n",
"bytes": 11202,
"sha": "3a6d752400fc4c56e37f843dd20c96b94e66d7bbdc7906ece02b729affa65e71",
"repo_slug": "debridge-finance/debridge-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_debridge_finance_debridge_mcp_3ada2d2b/readme"
}