MCPHub
CHANGELOG

MCPHub Changelog

Product releases for the open source MCPHub app, sourced from GitHub Releases.

Latest release
v1.2.6
Nov 18, 2026
  • v1.2.6

    Nov 18, 2026

    MCPHub 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
    FeatureFix
    View release
  • v1.2.5

    Nov 16, 2026

    v1.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.
    FeatureFix
    View release
  • v1.2.4

    Nov 14, 2026

    This 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.
  • v1.2.3

    Nov 11, 2026

    This 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.
    FeatureFix
    View release
  • v1.2.2

    Nov 7, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.2.1

    Nov 3, 2026

    MCPHub 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.
    FeatureFix
    View release
Show older releases (24)
  • v1.2.0

    Nov 1, 2026

    v1.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.
    FeatureFix
    View release
  • v1.1.15

    Oct 31, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.14

    Oct 29, 2026

    v1.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.
    FeatureFix
    View release
  • v1.1.13

    Oct 28, 2026

    This 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
    FeatureFix
    View release
  • v1.1.12

    Oct 27, 2026

    This 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.
  • v1.1.11

    Oct 27, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.10

    Oct 24, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.9

    Oct 23, 2026

    MCPHub 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
    FeatureFix
    View release
  • v1.1.8

    Oct 21, 2026

    MCPHub 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
    FeatureFix
    View release
  • v1.1.7

    Oct 19, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.6

    Oct 18, 2026

    This 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.
    FeatureFix
    View release
  • v1.1.5

    Oct 16, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.4

    Oct 15, 2026

    v1.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.
    FeatureFix
    View release
  • v1.1.3

    Oct 11, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.2

    Oct 8, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.1.1

    Oct 7, 2026

    This 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
    FeatureFix
    View release
  • v1.1.0

    Oct 3, 2026

    v1.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.
    FeatureFix
    View release
  • v1.0.46

    Oct 3, 2026

    This 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).
    FeatureFix
    View release
  • v1.0.45

    Oct 2, 2026

    MCPHub 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
  • v1.0.44

    Sep 30, 2026

    This 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.
    FeatureFix
    View release
  • v1.0.43

    Sep 30, 2026

    MCPHub 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.
    FeatureFix
    View release
  • v1.0.42

    Sep 28, 2026

    MCPHub 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.
  • v1.0.41

    Sep 26, 2026

    This 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
    FeatureFix
    View release
  • v1.0.40

    Sep 24, 2026

    This 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
    FeatureFix
    View release
All releases on GitHub
MCPHub Changelog · MCPHub