How to Install MCPX - MCP Gateway in OpenAI Agents SDK

A lightweight, open-source gateway for orchestrating and securing your MCP ecosystem.

What MCPX - MCP Gateway does

Lunar.dev MCPX is a lightweight, centralized gateway for managing and securing your local-first MCP workflows. Designed for developers working with multiple MCP-compatible tools and services, MCPX acts as a smart proxy, routing requests, enforcing permissions, and simplifying integrations across your stack. At its core, MCPX helps you: * Dynamically route between multiple MCP servers * Connect to tools and services with zero code via simple JSON configuration * Expose a unified API interface across disparate services * Adopt a remote-first approach without losing the local flexibility MCP offers Whether you're exploring how to structure secure agent workflows or deploying agents into production environments, this documentation will walk you through every step, from setup to advanced configurations.

mcp_gateway

mcp_aggregator

control_plane

agent_governance

mcp_governance

Installation steps

1Install: pip install openai-agents
2Copy the snippet below into your agent code
3Replace placeholder env values with your real keys
4Pass mcp_servers=[mcp_server] to your Agent()

Python snippet

Python snippetpython

from agents import Agent
from agents.mcp import MCPServerStdio

mcp_server = MCPServerStdio(
    command="docker",
    args=["run", "--rm", "--pull", "always", "--privileged", "-v", "./:/lunar/packages/mcpx-server/config", "-p", "9000:9000", "-p", "5173:5173", "-p", "3000:3000", "--name", "mcpx", "us-central1-docker.pkg.dev/prj-common-442813/mcpx/mcpx:latest"],
)

agent = Agent(
    name="My Agent",
    model="gpt-4o",
    mcp_servers=[mcp_server],
)

Full server details GitHub Open Config Editor

Install in other clients

🤖Claude Desktop 💻Claude Code ⌨️Cursor 🏄Windsurf ♊Gemini

For maintainers

If you maintain MCPX - MCP Gateway, add this badge to your README to show it's verified on CuratedMCP:

[![CuratedMCP Verified](https://www.curatedmcp.com/api/badge/mcpx-mcp-gateway)](https://www.curatedmcp.com/marketplace/mcpx-mcp-gateway)