Xplore MCP Server

A Model Context Protocol (MCP) server for Router Protocol's Xplore API — enabling AI agents to find optimal cross-chain and same-chain swap routes, check fees and conditions, track transactions, and initiate trades across major blockchain networks.

Transport Modes

The Xplore MCP server supports two transport modes:

• stdio (default) - Requires Node.js/npm. For local agent frameworks and CLI tools via standard input/output
• HTTP streaming - Requires Docker OR Node.js/npm. For containerized deployments and web-based agents

Setup

Quick Start (npx)

Run directly without installation:

npx -y @routerprotocol/xplore-mcp@latest

Installation from Source

Clone and build:

git clone https://github.com/router-protocol/xplore-mcp.git
cd xplore-mcp
npm install
npm run build

Running the Server

stdio mode (default):

npx -y @routerprotocol/xplore-mcp@latest
# or from a cloned repo
npm start

HTTP mode:

MCP_TRANSPORT=http npx -y @routerprotocol/xplore-mcp@latest
# or from a cloned repo
npm run start:http

# Custom port
MCP_TRANSPORT=http PORT=3001 npx -y @routerprotocol/xplore-mcp@latest

Docker HTTP mode:

docker build -t xplore-mcp .
docker run -p 3000:3000 xplore-mcp

Configuration for Agent Frameworks

stdio configuration (for local agents):

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

Streamable HTTP:

"xplore": {
  "type": "streamable-http",
  "url": "http://localhost:3001/mcp"
}

Add the MCP server:

claude mcp add xplore npx -- -y @routerprotocol/xplore-mcp@latest
# OR
claude mcp add xplore --transport http http://127.0.0.1:3000/mcp

Verify the connection:

claude mcp list

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

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

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

{
  "mcpServers": {
    "xplore": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@routerprotocol/xplore-mcp@latest"]
    }
  }
}

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

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

Open Cline settings in VS Code, go to MCP Servers, click "Edit MCP Settings" and add:

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

Add to ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "xplore",
      "command": "npx",
      "args": ["-y", "@routerprotocol/xplore-mcp@latest"]
    }
  ]
}

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

{
  "context_servers": {
    "xplore": {
      "command": {
        "path": "npx",
        "args": ["-y", "@routerprotocol/xplore-mcp@latest"]
      }
    }
  }
}

Development

# Run in dev mode (no build needed)
npm run dev

# Test with MCP Inspector
npm run inspect

# Run tests
npm test

License

MIT, Copyright 2026 Router Protocol