Skip to content

Conversation

@olaservo
Copy link
Member

@olaservo olaservo commented Nov 23, 2025

Description

This PR updates documentation across multiple files to inform contributors that we are no longer accepting PRs to add servers to the README. Instead, contributors should publish their servers to the MCP Server Registry to make them discoverable to the broader MCP ecosystem.

Fixes #2720

Publishing Your Server

N/A - This PR updates documentation, not a server.

Server Details

N/A - This PR modifies the pull request template, not a specific server.

Motivation and Context

As the MCP ecosystem grows, the MCP Server Registry provides a centralized, structured way for users to discover and install servers. Adding servers directly to the README:

  • Doesn't scale well as the number of servers increases
  • Lacks structured metadata for discovery
  • Requires manual PR review for simple additions
  • Makes it harder for users to search and filter servers

The MCP Server Registry solves these problems by providing:

  • A searchable, structured catalog of servers with a simple UI at https://registry.modelcontextprotocol.io/
  • Automated publishing workflow via mcp-publisher
  • Better discoverability for the MCP ecosystem
  • Reduced maintenance burden on this repository

This change implements a new policy: we are no longer accepting PRs to add servers to the README. Contributors must use the MCP Server Registry instead.

How Has This Been Tested?

N/A

Breaking Changes

N/A

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Protocol Documentation
  • My changes follows MCP security best practices
  • I have tested this with an LLM client - N/A (documentation only)
  • My code follows the repository's style guidelines
  • New and existing tests pass locally - N/A (no code changes)
  • I have added appropriate error handling - N/A (documentation only)
  • I have documented all environment variables and configuration options - N/A

Additional context

See: related convo in Discord: https://discord.com/channels/1358869848138059966/1399791593136980128/1440434048647565424

Updated pull request template to inform contributors that adding servers to
the README is deprecated. Contributors should now publish servers to the MCP
Server Registry instead, following the quickstart guide.

Changes:
- Added "Publishing Your Server" section with deprecation notice
- Updated checklist to include MCP Registry publishing
- Clarified README item refers to server's own documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@olaservo olaservo marked this pull request as draft November 23, 2025 18:45
@olaservo olaservo marked this pull request as ready for review November 23, 2025 19:04
@olaservo
Copy link
Member Author

For transparency: we are still discussing timing and details on this change in the contributor Discord.

@olaservo olaservo marked this pull request as draft November 23, 2025 19:19
Copy link
Member

@tadasant tadasant left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small comments but generally makes sense to me!

Copy link
Member

@cliffhall cliffhall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reworded the note about how the README lists are maintained.

@olaservo olaservo marked this pull request as ready for review November 25, 2025 03:51
domdomegg
domdomegg previously approved these changes Nov 25, 2025
Copy link
Member

@domdomegg domdomegg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Happy to merge as-is, might want to simplify the links as per comments above.

Address review feedback from @domdomegg to simplify the quickstart
links by removing the anchor to a specific step. Users should see
the full quickstart including verification, and simpler links are
more robust if docs reorganize.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
This repository is a collection of *reference implementations* for the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), as well as references to community-built servers and additional resources.

> [!IMPORTANT]
> If you are looking for a list of MCP servers, you can browse published servers on [the MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's just my two cents.

Suggested change
> If you are looking for a list of MCP servers, you can browse published servers on [the MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group.
> If you are looking for a list of MCP servers, you can browse published servers on the [MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group.

Copy link
Member

@koic koic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This update makes sense 👍

@olaservo olaservo dismissed cliffhall’s stale review November 26, 2025 14:06

Applied the suggested changes

@olaservo olaservo merged commit 90369c8 into modelcontextprotocol:main Nov 26, 2025
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Redirect people to the registry?

5 participants