MCPHub Changelog
Product releases for the open source MCPHub app, sourced from GitHub Releases.
v1.2.6
Nov 18, 2026MCPHub v1.2.6 adds passkey sign-in for local accounts, personal OAuth for OpenAPI servers, and a setting for the HTTP listen address.
- Support personal OAuth for OpenAPI servers
- Add passkey (WebAuthn) sign-in for local accounts
- Add MCPHUB_HOST to configure the HTTP listen address
FeatureFixView releasev1.2.5
Nov 16, 2026v1.2.5 adds opt-in OpenAI-compatible tool names and the first backend/API implementation of file staging for configured stdio tools.
- Add optional OpenAI-compatible tool names in System Settings, disabled by default. Reconnect clients after changing the setting.
- Add opt-in file staging for configured stdio tools, including upload, status, and download tools. This release delivers the backend/API; browser upload UI and Smart Routing integration remain future work.
- Avoid list-change notification loops when upstream lists have not changed.
FeatureFixView releasev1.2.4
Nov 14, 2026This release improves upstream MCP discovery, database recovery, and imported OpenAPI tool compatibility.
- Discover all pages of upstream tools, prompts, resources, and resource templates so later-page capabilities remain available.
- Bound database reconnection initialization and cleanup, isolate late completions, and keep health probes responsive during recovery.
- Normalize imported OpenAPI nullable input schemas while preserving required fields and validation constraints.
FixView releasev1.2.3
Nov 11, 2026This release adds group-scoped personal API keys for tighter agent access control and improves upstream compatibility and recovery.
- Restrict personal API keys to selected groups, with scope controls in the dashboard. Existing unrestricted keys retain their behavior.
- Route resources/read requests through matching upstream resource templates when the URI is absent from the static resource list, while respecting group resource selections.
- Return an actionable authorization error when missing personal OAuth leaves no tools available during discovery.
FeatureFixView releasev1.2.2
Nov 7, 2026MCPHub v1.2.2 makes credentials and application access easier to manage with credential copying, optional remembered OAuth consent, and application revocation.
- Copy personal credentials between compatible servers, with overwrite confirmation and independent copies.
- Read forward-auth JWTs from a configurable header, including Cloudflare Access headers.
- Optionally remember OAuth consent and let users revoke authorized applications; confirmation on every authorization remains the default.
FeatureFixView releasev1.2.1
Nov 3, 2026MCPHub v1.2.1 improves upstream connection stability and OpenAPI parameter compatibility, adds narrowly scoped Fake-IP exceptions, and restores Authorization passthrough through an explicit administrator opt-in.
- Add admin-managed Fake-IP exceptions scoped to an upstream server and exact hostname for SSE and Streamable HTTP connections.
- Document one-click deployment options in the Docker deployment guide.
- Restore upstream Authorization passthrough through an explicit admin opt-in, disabled by default; requires a separate MCPHub authentication header and trusted upstream configuration, and remains unavailable in hosted mode.
FeatureFixView release
Show older releases (24)
v1.2.0
Nov 1, 2026v1.2.0 introduces experimental cluster support through an opt-in PostgreSQL multi-replica mode.
- Experimental cluster / multi-replica mode (disabled by default): enable MCPHUBREPLICAMODE=true to run multiple instances against shared PostgreSQL. Configuration changes converge every five seconds, stale configuration writes are rejected, and OAuth state, authorization-code consumption and credential refresh are coordinated across nodes.
- Deployment and operations: Docker Compose and Kubernetes examples include separate schema setup, two replicas and load-balancer affinity. Liveness/readiness checks, node/configuration diagnostics, metrics and graceful HTTP draining help operate replicas. Use shared persistent JWT and credential-encryption keys, run schema setup separately, and set DB_SYNCHRONIZE=false on serving nodes. See the replica deployment guide.
- Experimental boundaries: MCP sessions, isolated upstream clients, cookie jars and local files remain process-local. Stateful clients require sticky routing and reinitialization after node loss; in-flight calls are neither migrated nor replayed. PostgreSQL and load-balancer high availability remain deployment responsibilities. Evaluate in a test environment before adopting this mode in production.
FeatureFixView releasev1.1.15
Oct 31, 2026MCPHub v1.1.15 adds user-group sharing, more flexible system bearer-key scopes, masked personal credential previews, and opt-in OAuth authorization relay for private brokers.
- Share servers and Group routes with administrator-managed user groups while retaining underlying server permissions and tool policies.
- Identify saved personal credentials through masked previews on your own Credentials page.
- Enable personal OAuth authorization relay for explicitly configured private brokers, with allowed HTTPS redirect origins.
FeatureFixView releasev1.1.14
Oct 29, 2026v1.1.14 makes MCPHub easier to govern and steadier in real-world deployments.
- Enforce unified MCP tool access policies, including a Settings → Tool access policies editor for administrators.
- Let administrators provision, inspect, replace and delete other users' personal credentials from the Credentials page and the Users page.
- Allow administrators to customize the dashboard name, applied immediately to the sidebar, header, login page and browser tab.
FeatureFixView releasev1.1.13
Oct 28, 2026This release adds Bearer key resets that preserve permissions and improves personal credential binding migration and embedding provider compatibility.
- Reset Bearer keys while preserving permissions
- Validate and independently migrate personal credential bindings
- Negotiate embedding encoding at runtime for better provider compatibility
FeatureFixView releasev1.1.12
Oct 27, 2026This release strengthens personal-credential and Bearer key storage.
- Personal credentials (#1393): Database mode no longer generates a local encryption key automatically. Configure MCPHUBCREDENTIALENCRYPTION_KEY or retain an existing valid key file; keep the same key across upgrades and instances. A database backup alone cannot recover bindings if the key is lost. See the upgrade and recovery guide for working deployments and lost-key recovery.
- Bearer keys (#1387): Store SHA-256 hashes instead of plaintext, with automatic migration at startup. Existing client tokens keep working; newly created tokens are returned only once. After migration, do not run an older version against the migrated database/settings—restore a pre-upgrade backup to roll back. When switching from file to database mode, run this version in file mode first or remove leftover plaintext keys from the source settings file.
FixView releasev1.1.11
Oct 27, 2026MCPHub v1.1.11 improves upstream compatibility and connection resilience with modern HTTP negotiation, explicit OAuth authorization-server metadata, and automatic background reconnection.
- Optionally preserve original upstream tool names in groups and group Smart Routing, with collision checks.
- Configure explicit OAuth authorization-server metadata for shared and personal upstream connections.
- Restore last-known tool catalogs for on-demand stdio servers after restart without starting matching upstreams.
FeatureFixView releasev1.1.10
Oct 24, 2026MCPHub v1.1.10 makes upstream connections easier to inspect by displaying negotiated MCP protocol versions separately from server software versions.
- Display each upstream MCP server’s negotiated protocol version alongside its transport, separately from its software version.
- Improve server list row layout to prevent token statistics from overlapping controls and reduce server name truncation.
- Show the full, wrapped server description on expanded cards.
FeatureFixView releasev1.1.9
Oct 23, 2026MCPHub v1.1.9 makes large servers easier to manage with searchable bulk curation for tools, prompts, and resources plus a batch status API, and lets HTTP servers share one definition across regional or tenant endpoints through personal URL credential slots.
- Add Vietnamese locale support
- Support personal URL credential slots for HTTP servers
- Forward elicitation for isolated legacy tool calls
FeatureFixView releasev1.1.8
Oct 21, 2026MCPHub v1.1.8 adds opt-in local account self-registration and per-tool input-schema parameter hiding.
- Add opt-in local account self-registration
- Hide input-schema parameters per tool
- Show server-reported versions when runner package versions are unavailable
FeatureFixView releasev1.1.7
Oct 19, 2026MCPHub v1.1.7 adds group-level instructions for MCP clients, optional Prometheus metrics, managed pruning for declarative settings, and an opt-in guard for high-risk tool-call arguments.
- Configure group instructions returned during MCP initialization, including smart group routes and multi-server groups.
- Enable Prometheus metrics with ENABLEMETRICS=true; optionally protect /metrics with a dedicated METRICSTOKEN bearer credential.
- Use MCPHUBSETTINGSSYNC=prune to permanently remove deleted settings-managed servers and groups at startup while preserving unmanaged dashboard entries.
FeatureFixView releasev1.1.6
Oct 18, 2026This release adds configurable Smart Routing paths while preserving existing $smart URLs.
- Configure Smart Routing endpoints with SMARTROUTINGPATH; existing $smart URLs remain supported.
- Disable local command installations for non-admin users in Marketplace and Registry, with an explanation, while keeping supported remote installations available.
- Allow credential slots when OAuth contains only the default shared identity setting, and preserve credential bindings when renaming affected legacy servers.
FeatureFixView releasev1.1.5
Oct 16, 2026MCPHub v1.1.5 adds Spanish localization and improves API validation and tool-list synchronization.
- Add Spanish (es) localization to the interface, with Español available in the language menu.
- Return HTTP 400 for non-numeric page or limit parameters in server-list requests.
- Notify tool listeners when a server is removed from a group, allowing connected clients to refresh their tool lists.
FeatureFixView releasev1.1.4
Oct 15, 2026v1.1.4 expands personal upstream authentication with independent OAuth connections and credential slots in stdio arguments.
- Support personal upstream OAuth bindings, with per-user authorization and dashboard connection controls.
- Support personal credential slots in stdio arguments using explicit {{args.API_KEY}} placeholders.
- Publish path-aware OAuth protected-resource metadata and matching authentication challenges.
FeatureFixView releasev1.1.3
Oct 11, 2026MCPHub v1.1.3 adds administrator-managed CIDR allowances for upstream access and improves compatibility for CLI tool calls, MCP Apps widgets on idle on-demand servers, and stateful tools in ChatGPT Work/Codex.
- Allow administrators to configure IPv4/IPv6 CIDR ranges for upstream access through Settings or systemConfig.network.allowedCidrs.
- Initialize MCP sessions for CLI tool calls, fixing HTTP 400 errors caused by missing session IDs.
- Wake idle on-demand servers when reading their ui:// widgets, preventing premature “Resource not found” errors.
FeatureFixView releasev1.1.2
Oct 8, 2026MCPHub v1.1.2 adds JWKS-based forward authentication and enables MCP Apps widgets for pinned tools on smart-routing group endpoints.
- Add JWKS-based forward authentication for dashboard APIs and MCP transports.
- Preserve MCP Apps metadata on pinned tools at $smart/{group}, enabling widgets for compatible clients.
- Cancel queued on-demand discovery when tools are already cached or the runtime is no longer eligible, avoiding duplicate server processes.
FeatureFixView releasev1.1.1
Oct 7, 2026This release hardens deployments and trims what reaches the model.
- Disable username/password login while an SSO provider is enabled (betterAuth.disablePasswordLogin), removing the weaker second sign-in path from SSO-only deployments, with BETTERAUTHDISABLEPASSWORDLOGIN as the recovery override
- Configure which MCP tool fields searchtools and describetool return (smartRouting.toolDefinitionFields); the new title + annotations default cuts a typical search response by roughly half
- Reconcile declarative mcpsettings.json servers and groups on every startup in database mode with the opt-in MCPHUBSETTINGS_SYNC=upsert
FeatureFixView releasev1.1.0
Oct 3, 2026v1.1.0 marks completion of the dual-stack baseline and defined acceptance checks for the staged MCP 2026-07-28 migration tracked in #1220.
- Advertise positive private TTLs for modern tools, prompts, resources, and resource-template lists when upstream discovery freshness is trustworthy, capped by the shortest remaining discovery lifetime and a five-second gateway budget. Uncertain freshness keeps TTLs at zero.
- Document the bounded positive list TTL policy and legacy SSE deprecation and migration plan. by @samanhappy in https://github.com/samanhappy/mcphub/pull/1276 and https://github.com/samanhappy/mcphub/pull/1275
- Prevent modern requests from inheriting legacy session group scope; route them using their URL and authenticated context while preserving legacy session continuation.
FeatureFixView releasev1.0.46
Oct 3, 2026This release strengthens server configuration isolation, adds conservative cache hints for modern MCP clients, and improves dashboard editing and readability.
- Add private cache scope and conservative TTL hints for modern MCP responses.
- Document MCP protocol compatibility and migration, and clarify PostgreSQL connection-pool sizing.
- Isolate server configuration environment expansion according to the owner's live privileges, including HTTP/SSE headers and reconnect paths (GHSA-547h-r8jj-9wmc).
FeatureFixView releasev1.0.45
Oct 2, 2026MCPHub v1.0.45 improves REST tool result fidelity, OpenAPI parameter handling, and MCP Apps compatibility for stateless clients.
- Preserve complete REST tool call results, including structured output, tool errors, and metadata,
- Include path-level OpenAPI parameters in generated tools, with operation-level overrides,
- Use per-request client capabilities to enable MCP Apps for compatible stateless clients
FixView releasev1.0.44
Sep 30, 2026This release lets authenticated modern MCP clients reuse isolated state for session-dependent tools through X-MCPHub-State-Id, fixes upstream OAuth authorization callbacks after the SDK v2 migration, and improves routing compatibility coverage and contributor documentation.
- Enable isolated upstream connections and OpenAPI cookie state across modern MCP requests using a client-generated UUID v4 in X-MCPHub-State-Id. State is bound to the authenticated credential, user, and route, and expires after 30 minutes of inactivity.
- Restore persisted OAuth discovery state and forward callback issuer information to fix authorization-code exchange failures after the SDK v2 migration. Pending flows created without discovery state must be restarted.
- Correct nonexistent commands and file paths in the contributor guide.
FeatureFixView releasev1.0.43
Sep 30, 2026MCPHub v1.0.43 adds a dual-stack HTTP path for MCP 2026-07-28 requests while preserving legacy Streamable HTTP behavior.
- Add a stateless HTTP path for MCP 2026-07-28 requests alongside legacy Streamable HTTP. Stateful upstream compatibility remains limited.
- Show scores for search_tools results, configure the similarity threshold, clarify empty matches, and limit full schemas to the top N results.
- Pin selected group tools alongside meta-tools on the group's $smart endpoint.
FeatureFixView releasev1.0.42
Sep 28, 2026MCPHub v1.0.42 upgrades to MCP SDK v2.1 while preserving legacy protocol compatibility, fixes environment-variable expansion during tool-call reconnects, and restores OAuth compatibility with upstream servers that do not advertise issuer response support.
- Expand environment variables in server configuration before tool-call reconnects, so SSE and Streamable HTTP retries use the expected URLs and credentials.
- Remove the render-blocking Google Fonts dependency and use system fonts in the Dashboard.
- Correct smart-routing documentation to use DBPOOLSIZE and remove unsupported DATABASE_TIMEOUT.
FixView releasev1.0.41
Sep 26, 2026This release makes Smart Routing more flexible and more transparent.
- Hide the Cloud Support (MCPRouter) tab in the marketplace
- Add an optional embedding query and document prefixes to Smart Routing
- Persist the server description mode configured via the system config API
FeatureFixView releasev1.0.40
Sep 24, 2026This release makes Smart Routing observable and the server more resilient under load.
- Add Smart Routing performance diagnostics and forced-reindex API endpoints with a dashboard panel
- Harden database reconnection and the hot path against pool wedges with bounded teardown, health-check and connection timeouts
- Preserve safe upstream failure diagnostics instead of blaming credentials for transport and tool errors
FeatureFixView release