Release 1.38.2 - MCP Apps Through Virtual Servers, Multiline Skill Descriptions
November 2026
Upgrading from 1.38.1
This section covers everything you need to know to upgrade from 1.38.1 to 1.38.2.
Breaking Changes
There are no breaking changes in this release.
Other upgrade notes
- A virtual server asks MCP App backends for their tools live. With
TOOL_REFRESH_ENABLED=true, 1.38.1 answered every non-egress backend'stools/listfrom the stored tool list. A backend with an MCP App tool is now asked live on each connect, like an egress backend, so its tools keep their_metaandexecutionfields. Other backends still answer from the stored list. (#2095) - Claude keeps a page it failed to show. A user who saw "There was a problem displaying content" for an MCP App behind a virtual server should remove the connector and add it again after the upgrade, so Claude fetches the page again. (#2095)
- SKILL.md frontmatter is parsed as YAML. When the registry reads a SKILL.md to fill in a skill's name, description, version and tags (the registration form's parse step,
POST /api/skills/parse-skill-md), it now uses a YAML parser, so folded (>) and literal (|) descriptions work. Frontmatter that is not valid YAML is ignored, and the name and description then come from the document body. This happens, for example, with an unquoted description containing:, one that starts with[or@, or one indented with tabs. An unquoted#starts a YAML comment, so the rest of the line is dropped. Quote such descriptions. Skills already registered keep their stored values. (#2094)
New Environment Variables
No new environment variables in this release.
Upgrade Instructions
Deploy the 1.38.2 images for the registry, auth-server and mcpgw.
Docker Compose
cd mcp-gateway-registry
git pull origin main
git checkout 1.38.2
./build_and_run.shKubernetes / Helm (EKS)
cd mcp-gateway-registry
git pull origin main
git checkout 1.38.2
# REQUIRED: the image tags in the subcharts changed, so rebuild the packaged dependencies
cd charts/mcp-gateway-registry-stack
helm dependency build
helm dependency update
# Update values.yaml if needed, then upgrade:
helm upgrade mcp-gateway . -f your-values.yamlTerraform / ECS
cd mcp-gateway-registry
git pull origin main
git checkout 1.38.2
cd terraform/aws-ecs
terraform plan
terraform applyMajor Features
MCP Apps through virtual servers
MCP Apps did not open through a virtual server in 1.38.1, for two separate reasons. This release fixes both. In Claude Cowork, the draw.io MCP App now renders through a virtual server, as it does on its direct route.
- With
TOOL_REFRESH_ENABLED=true, 1.38.1 answered a virtual server'stools/listfrom the stored tool list. That copy keeps a tool'stitle,annotationsandoutputSchemabut not its_meta, which holds the app'sui://page address, so MCP App tools reached clients without it. A backend with an MCP App tool is now asked live, and its tools keep_meta(vendor keys included) andexecution. - Claude shows an MCP App page only when its
_meta.ui.domainis the hash of the connector URL the user added. The gateway corrects a backend's value on direct routes; on virtual servers it did not, so a page that sets the value, as draw.io does, was refused. The registry now computes the expected value for each connector path of a virtual server and writes it into the server's mapping, and the virtual router applies the same rule toresources/readreplies.
Some limits remain on virtual servers, such as tools renamed by the virtual server and pages that rely on the client's UI capability reaching the backend. MCP Apps lists them, and #2034 tracks the rest of the work.
What's New
Skills
- SKILL.md frontmatter is read with a data-only YAML loader. Folded and literal descriptions keep their text, quoted values keep their escapes, and
version: 1.10stays the string1.10. The parser refuses aliases, explicit tags, invalid Unicode, nesting deeper than 32 levels and frontmatter over 64 KB. (#2094)
Documentation
- MCP Apps now lists virtual servers as supported, with the limits that remain. Virtual server operations and tool list refresh say that MCP App backends are asked live. (#2095)
Bug Fixes
- MCP App tools reached clients without their
_metathrough a virtual server whenTOOL_REFRESH_ENABLEDwas on, so no app opened. (#2095) - An MCP App page that sets
_meta.ui.domainwas refused by Claude behind a virtual server. (#2095) - A SKILL.md description written as a folded or literal YAML block came through as
>or|. (#2094)
Closed Issues
| Issue | Title | Closed By |
|---|---|---|
| #2092 | SKILL.md parser returns > or | instead of multiline YAML descriptions | PR #2094 |
Pull Requests Included
| PR | Title |
|---|---|
| #2095 | fix(virtual): make MCP Apps work through virtual servers |
| #2094 | fix(skills): honor YAML block scalars in SKILL.md descriptions |
Contributors
Thank you to all contributors for this release:
Support
Full Changelog: 1.38.1...1.38.2