mcp-federation
Federates a Bitbucket MCP server behind the local gateway, making its repository and pull-request tooling available to MCP clients through a single Streamable HTTP endpoint.
Federates a Confluence MCP server behind the local gateway, exposing Confluence's content and page management tools, with optional tool prefixing and eager loading.
Federates a Jira MCP server behind the local gateway, exposing Jira's tools (issue tracking, projects, and related operations) to the MCP client once the service is activated.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-federation
Local MCP gateway that federates multiple OAuth-protected HTTP MCP servers (Jira, Bitbucket, Confluence, …) behind a single Streamable HTTP endpoint.
One place to authorize: OAuth 2.1 (PKCE + Dynamic Client Registration, static
clientIdfallback), silent refresh, re-authorization without restartLazy tool loading: a session sees only
gateway_infountil a service is activatedWorks with any MCP client that speaks Streamable HTTP
Quick start
git clone git@github.com:rahmanroman/mcp-federation.git
cd mcp-federation
npm install
npm link # builds and installs the global `mcp-federation` command
mcp-federation add jira https://mcp.corp.example.com/jira/mcp
mcp-federation startUpdate: git pull && npm install (rebuilds dist/; the link stays). Uninstall: npm unlink -g mcp-federation.
Point your MCP client at http://127.0.0.1:3117/mcp. For Claude Code:
claude mcp add --transport http mcp-federation http://127.0.0.1:3117/mcpRelated MCP server: mcp-gw
CLI
mcp-federation start [-p | --port <n>] [--notify]
mcp-federation add <name> <url> [--prefix <p>]
mcp-federation remove <name>
mcp-federation list
mcp-federation get <name>Config — ~/.mcp-federation/config.json
{
"port": 3117,
"notify": false,
"lazy": true,
"services": {
"jira": { "url": "https://mcp.corp.example.com/jira/mcp" },
"confluence": {
"url": "https://mcp.corp.example.com/confluence/mcp",
"toolPrefix": "confluence_",
"eager": true,
"scope": "read write offline_access",
"clientId": "only-if-no-DCR"
}
}
}Services listed earlier win tool name collisions; use toolPrefix to avoid them. eager exposes a service's tools without activation (for clients that ignore tools/list_changed).
Development
npm test # end-to-end test against mock OAuth-protected servers
npm run probe -- <url> [--register] # check a server's OAuth capabilities (DCR, PKCE, refresh)Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
Streamable HTTP MCP gateway for NV oOS fleets — one API key, namespaced tools, quotas and policy.
Toolstile is a managed MCP gateway that connects remote MCP servers behind one endpoint, with per-agent permissions, shared accounts and activity logs. Connect at https://mcp.toolstile.com/mcp over Streamable HTTP with OAuth; sign in at https://toolstile.com, select a workspace and connect your upstream servers. Available tools, resources and prompts depend on that workspace and the agent's granted access.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceAggregates multiple MCP servers behind a single, secure endpoint with unified tool/resource discovery, OAuth authentication, and resilient request routing. Enables users to manage and interact with multiple MCP backends through one centralized interface with load balancing and circuit breakers.2-
- AlicenseNot gradedqualityCmaintenanceAggregates multiple MCP servers into a single HTTP endpoint with tool namespacing, dashboard, and REST API for management.53 npmMIT
- AlicenseNot gradedqualityDmaintenanceAuthenticating reverse proxy for MCP servers providing credential isolation, OAuth2 token management, and composite tool aggregation.BSD Zero Clause
- AlicenseNot gradedqualityAmaintenanceEnables aggregating and routing multiple backend MCP resource servers so clients can access their combined tools and resources through a unified SSE, Streamable HTTP, or Stdio interface, with optional authentication and web-based management.120 npmMIT