{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ux3rj5qtstdz","handle":"mcp-env-mux","url":"https://wellknown.network/agents/mcp-env-mux","links":{"self":"https://wellknown.network/agents/mcp-env-mux/record.json","html":"https://wellknown.network/agents/mcp-env-mux","markdown":"https://wellknown.network/agents/mcp-env-mux/record.md","api":"https://wellknown.network/api/v1/agents/mcp-env-mux","status":"https://wellknown.network/api/v1/agents/mcp-env-mux/status","claim":"https://wellknown.network/agents/mcp-env-mux/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-env-mux/claim.json","badge":"https://wellknown.network/agents/mcp-env-mux/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-env-mux/history","tools":"https://wellknown.network/api/v1/agents/mcp-env-mux/tools"},"ard":{"identifier":"urn:air::server:mcp-env-mux","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-env-mux","summary":"Merge multiple instances of the same MCP server across environments into a single endpoint with a unified env parameter.","description":"# mcp-env-mux\n\nMerge multiple instances of the same MCP server across environments into a single endpoint with a unified `env` parameter.\n\n## Problem\n\nWhen you connect the same MCP server (e.g., Coralogix, Datadog) from multiple environments (prod, staging, dev), each instance exposes identical tool definitions. Your MCP client sees every tool duplicated per environment, wasting context window tokens and creating a confusing tool list.\n\n## Solution\n\nmcp-env-mux sits in front of your MCP backends as a proxy. It discovers tools from each backend, merges identical definitions into a single tool with an injected `env` parameter, and routes calls to the correct backend based on the caller's `env` selection. One tool instead of N copies.\n\n## Quick Start\n\n### Without auth\n\n```bash\n# Install\npip install -e .\n\n# Set your API keys as environment variables\nexport BACKEND_PROD_API_KEY=\"your-prod-key\"\nexport BACKEND_STAGING_API_KEY=\"your-staging-key\"\n\n# Create a config file (see Configuration below)\n\n# Validate your config and check for schema mismatches\nmcp-env-mux --config config.json --test-schema\n\n# Start the proxy\nmcp-env-mux --config config.json\n```\n\n### With auth enabled\n\n```bash\n# Optional: set Azure client secret via env var\nexport AZURE_CLIENT_SECRET=\"your-azure-client-secret\"\n\n# Start the proxy with an auth-enabled config\nmcp-env-mux --config config.json\n```\n\nWhen the `auth` block is present in the config, the proxy enables JWT Bearer auth, OAuth login routes, RBAC enforcement for tool calls, and a UI for minting long-lived bot tokens.\n\nThe proxy also exposes operational HTTP endpoints:\n- `/metrics` (or your configured metrics path) for Prometheus metrics\n- `/healthz` for process liveness\n- `/readyz` for startup readiness\n\n> For Azure / Microsoft Entra ID setup from scratch, including **both** required redirect URIs (`/auth/callback` and `/ui/callback`), see **`AZURE_SETUP.md`**.\n\n## Configuration\n\nThe config file is JSON with a required `environments` object and an …","publisher":null,"homepage":"https://github.com/anuragrao04/mcp-mux","repository":"https://github.com/anuragrao04/mcp-mux","version":"0.3.7","license":null,"protocols":["mcp"],"tags":["ai","environment","mcp","multiplexer","proxy","tools"],"pricing":null,"endpoints":[{"url":"pypi:mcp-env-mux","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":0.836,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.745,"provenance":"derived"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-env-mux","registry":"pypi","observedAt":"2026-11-03T13:26:35.807Z","publishedAt":"2026-05-05T12:07:32.279200Z","latestVersion":"0.3.7"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-env-mux","url":"https://pypi.org/project/mcp-env-mux/","firstSeenAt":"2026-09-10T01:20:27.226Z","fetchedAt":"2026-11-03T13:24:57.751Z","normalizedAt":"2026-11-03T13:24:57.751Z"}]},"firstSeenAt":"2026-09-10T01:20:27.226Z","updatedAt":"2026-11-03T13:26:35.807Z"}