Skip to main content

Getting Started

This guide covers how to install and configure the Xplore MCP Server for your AI agent framework.

Prerequisites​

  • Node.js >= 18 (for stdio and HTTP modes)
  • Docker (optional, for containerized HTTP deployments)

Quick Start​

Run the server directly without installation:

npx -y @routerprotocol/xplore-mcp@latest

Transport Modes​

The Xplore MCP server supports two transport modes:

stdio (Default)​

Standard input/output mode for local agent frameworks and CLI tools. Requires Node.js/npm.

npx -y @routerprotocol/xplore-mcp@latest

HTTP Streaming​

For containerized deployments and web-based agents. Requires Docker or Node.js/npm.

MCP_TRANSPORT=http npx -y @routerprotocol/xplore-mcp@latest

# 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

Agent Framework Configuration​

Generic stdio Configuration​

For any MCP-compatible agent that accepts JSON configuration:

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

Generic HTTP Configuration​

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

Claude Code (CLI & IDE Plugins)​

Add the MCP server:

claude mcp add xplore npx -- -y @routerprotocol/xplore-mcp@latest

Or for HTTP transport:

claude mcp add xplore --transport http http://127.0.0.1:3000/mcp

Verify the connection:

claude mcp list

Cursor​

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

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

GitHub Copilot (VS Code)​

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

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

Windsurf​

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

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

Cline​

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"]
    }
  }
}

Continue​

Add to ~/.continue/config.json:

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

Zed​

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

{
  "context_servers": {
    "xplore": {
      "command": {
        "path": "npx",
        "args": ["-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

Run from source:

# stdio mode
npm start

# HTTP mode
npm run start:http

Environment Variables​

VariableDefaultDescription
MCP_TRANSPORTstdioTransport mode: stdio or http
PORT3000HTTP server port (HTTP mode only)
HOST0.0.0.0HTTP server host (HTTP mode only)
XPLORE_API_BASEhttps://xplore.api.v2.routerprotocol.comXplore API base URL

Next Steps​