modelcontextprotocol / modelcontextprotocol/registry

Wrong server schema breaks clients

Open
#783 1 comment 0 reactions 1 assignee View on GitHub

@rdimitrov is already working on this.

Since Nov 21, 2025.

bug
Dominant language
Go
Stars
7.3k
Forks
994
Avg merge
4d 12h
Merged PRs (30d)
19

Description

Describe the bug
Servers from https://registry.modelcontextprotocol.io/ use the wrong schema. This causes clients like VSCode to break.

To Reproduce
Steps to reproduce the behavior:

  1. Set the VSCode config key "chat.mcp.gallery.serviceUrl": "https://registry.modelcontextprotocol.io/"
  2. Reload the window
  3. See in the Output window a serialization issues
  4. Search @mcp in the extension tab. You only have a limited amount of servers

Expected behavior
The server link the correct schema and not the schema from the time of publish.

Logs

Additional context
One example server is this one:

{
  "server": {
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-16/server.schema.json",
    "name": "ai.smithery/BowenXU0126-aistudio_hw3",
    "description": "Send personalized greetings with optional pirate flair. Compose friendly salutations for any name…",
    "repository": {
      "url": "https://github.com/BowenXU0126/aistudio_hw3",
      "source": "github"
    },
    "version": "1.16.0",
    "remotes": [
      {
        "type": "streamable-http",
        "url": "https://server.smithery.ai/@BowenXU0126/aistudio_hw3/mcp",
        "headers": [
          {
            "description": "Bearer token for Smithery authentication",
            "value": "Bearer {smithery_api_key}",
            "name": "Authorization"
          }
        ]
      }
    ]
  },

It uses the 2025-09-16 which does not work and causes a serialization issue if schema validation is enabled. Setting the schema manually to 2025-09-29 resolves the issue.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.