MCPX Gateway
MCPX is a remote-first MCP aggregator that enables zero-code integration, unified access, and dynamic routing across multiple MCP servers. It offers tool-level access controls, usage visibility, and customization to streamline and secure agentic work
What is MCPX Gateway?
MCPX Gateway is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcpx is a remote-first mcp aggregator that enables zero-code integration, unified access, and dynamic routing across multiple mcp servers. it offers tool-level access controls, usage visibility, and c...
MCPX is a remote-first MCP aggregator that enables zero-code integration, unified access, and dynamic routing across multiple MCP servers. It offers tool-level access controls, usage visibility, and customization to streamline and secure agentic work
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCPX is a remote-first MCP aggregator that enables zero-code
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcpx-mcp-gatewayConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCPX Gateway
MCPX is a remote-first MCP aggregator and gateway from Lunar.dev that consolidates multiple MCP servers behind a single unified API endpoint with zero code changes required. It routes tool calls dynamically across registered MCP services, enforces tool-level access controls, provides usage visibility through a live Control Plane dashboard, and supports rate limiting and throttling to secure agentic workflows. Teams use MCPX to manage all their MCP server integrations centrally rather than configuring each one separately in every AI client.
Prerequisites
- Docker installed (recommended deployment path), or access to the Lunar.dev cloud-hosted MCPX
- One or more MCP servers already running or accessible that you want to aggregate
- An MCP-compatible client such as Claude Desktop or Cursor
- Access to docs.lunar.dev for your specific configuration reference
Review the official MCPX documentation
MCPX configuration is JSON-based with zero code required. Start by reading the get-started guide at docs.lunar.dev to understand the architecture before configuring.
https://docs.lunar.dev/mcpx/get_startedRun MCPX via Docker
The recommended way to run MCPX locally is with the official Docker image. Refer to the Docker Image Guide in the docs for the exact image tag and volume mounts.
docker pull lunarapi/mcpx
docker run -p 8080:8080 lunarapi/mcpxCreate your MCPX configuration file
MCPX uses a JSON configuration file to register MCP servers, define routing rules, and set access controls. Add each upstream MCP server as an entry.
{
"servers": [
{
"name": "my-upstream-server",
"url": "http://localhost:3000/mcp"
}
]
}Connect your MCP client to the MCPX gateway
Point Claude Desktop or Cursor at the MCPX gateway endpoint instead of individual MCP servers. MCPX handles routing to the correct upstream.
{
"mcpServers": {
"mcpx": {
"command": "npx",
"args": ["mcpx-mcp-gateway"]
}
}
}Monitor via the Control Plane
Open the MCPX Control Plane dashboard to inspect live traffic, review tool usage, and manage access policies across your registered MCP servers.
MCPX Gateway Examples
Client configuration
Claude Desktop config pointing to MCPX as a single gateway. All upstream MCP servers are managed inside MCPX rather than listed here.
{
"mcpServers": {
"mcpx": {
"command": "npx",
"args": ["mcpx-mcp-gateway"]
}
}
}Prompts to try
Example prompts when using MCPX as a unified gateway to multiple MCP servers.
- "List all the tools available through the MCPX gateway"
- "Search the web using the search MCP server connected through the gateway"
- "Use the file system tools to read my project README"
- "Show me which MCP servers are currently registered and active in the gateway"
- "Run a database query through the SQL server connected via MCPX"Troubleshooting MCPX Gateway
MCPX gateway starts but no upstream tools are visible in the client
Verify that your upstream MCP servers are running and reachable from the MCPX container or process. Check the MCPX config file for correct server URLs and restart the gateway after any changes.
Docker image fails to start or port conflict on 8080
Change the host port mapping using -p <your-port>:8080. Make sure no other service is binding to the same port. Check Docker logs with docker logs <container-id> for startup errors.
Tool calls are being blocked by access controls
Review the tool-level access control settings in your MCPX configuration. The Control Plane dashboard shows which tools are being denied and why. Update your policy configuration to allow the required tools.
Frequently Asked Questions about MCPX Gateway
What is MCPX Gateway?
MCPX Gateway is a Model Context Protocol (MCP) server that mcpx is a remote-first mcp aggregator that enables zero-code integration, unified access, and dynamic routing across multiple mcp servers. it offers tool-level access controls, usage visibility, and customization to streamline and secure agentic work It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCPX Gateway?
Follow the installation instructions on the MCPX Gateway GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCPX Gateway?
MCPX Gateway works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCPX Gateway free to use?
Yes, MCPX Gateway is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCPX Gateway Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCPX Gateway? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCPX Gateway in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCPX Gateway?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.