Unify multiple MCP servers behind a single endpoint with lazy loading, plugins, and role filtering.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-unify","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mcp-gateway [](https://pypi.org/project/mcp-gateway/) [](LICENSE) [](https://pypi.org/project/mcp-gateway/) Unify multiple MCP servers behind a single endpoint. Lazy loading, auto-cleanup, Python plugins, role-based filtering. ## The Problem If you use Claude Code or any MCP client with 3+ servers, you get: - Multiple subprocesses (~50MB each) - Duplicated config - No centralized control - No way to add custom Python tools without a full MCP server ## The Solution `mcp-gateway` runs **one process** that proxies N MCP servers on-demand: ``` Claude Code / MCP Client │ ▼ mcp-gateway (1 process) ├─ [plugin] Python @tool functions ← in-process, 0 overhead ├─ [lazy] filesystem-server ← subprocess spawned on first call ├─ [lazy] github-server ← subprocess spawned on first call └─ [lazy] playwright ← subprocess spawned on first call ↑ 5 min idle → auto-kill ``` ## Install ```bash pip install mcp-gateway ``` ## Quick Start ### 1. Create `gateway.yaml` ```yaml servers: filesystem: command: npx args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"] github: command: npx args: ["-y", "@modelcontextprotocol/server-github"] env: GITHUB_TOKEN: "${GITHUB_TOKEN}" enabled: false idle_timeout: 300 ``` ### 2. Run **stdio** (for Claude Code): ```bash mcp-gateway stdio --config gateway.yaml ``` **SSE** (for remote clients): ```bash mcp-gateway serve --config gateway.yaml --port 8765 ``` ### 3. Add to Claude Code ```json { "mcpServers": { "gateway": { "command": "mcp-gateway", "args": ["stdio", "--config", "/path/to/gateway.yaml"] } } } ``` ## Python Plugins Add custom tools with zero boilerplate: ```python from mcp_gateway import tool @tool(descri…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.