From 817e12161d3361ff2406d4afc72ef386ac488487 Mon Sep 17 00:00:00 2001 From: Jonathan Hefner Date: Wed, 21 Jan 2026 09:29:44 -0600 Subject: [PATCH] docs: Add preview disclaimer note to public documentation Add a `` component to all MDX files in `docs/modelcontextprotocol-io/` informing readers that the MCP Registry is currently in preview and that breaking changes or data resets may occur before general availability. The note also directs users to report issues on GitHub at https://github.com/modelcontextprotocol/registry/issues Co-Authored-By: Claude Opus 4.5 --- docs/modelcontextprotocol-io/about.mdx | 4 ++++ docs/modelcontextprotocol-io/authentication.mdx | 4 ++++ docs/modelcontextprotocol-io/faq.mdx | 4 ++++ docs/modelcontextprotocol-io/github-actions.mdx | 4 ++++ docs/modelcontextprotocol-io/moderation-policy.mdx | 4 ++++ docs/modelcontextprotocol-io/package-types.mdx | 4 ++++ docs/modelcontextprotocol-io/quickstart.mdx | 4 ++++ docs/modelcontextprotocol-io/registry-aggregators.mdx | 4 ++++ docs/modelcontextprotocol-io/remote-servers.mdx | 4 ++++ docs/modelcontextprotocol-io/terms-of-service.mdx | 4 ++++ docs/modelcontextprotocol-io/versioning.mdx | 4 ++++ 11 files changed, 44 insertions(+) diff --git a/docs/modelcontextprotocol-io/about.mdx b/docs/modelcontextprotocol-io/about.mdx index d93adf1..88253af 100644 --- a/docs/modelcontextprotocol-io/about.mdx +++ b/docs/modelcontextprotocol-io/about.mdx @@ -3,6 +3,10 @@ title: The MCP Registry sidebarTitle: About --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + The MCP Registry is the official centralized metadata repository for publicly accessible MCP servers, backed by major trusted contributors to the MCP ecosystem such as Anthropic, GitHub, PulseMCP, and Microsoft. The MCP Registry provides: diff --git a/docs/modelcontextprotocol-io/authentication.mdx b/docs/modelcontextprotocol-io/authentication.mdx index cadae54..c18268c 100644 --- a/docs/modelcontextprotocol-io/authentication.mdx +++ b/docs/modelcontextprotocol-io/authentication.mdx @@ -3,6 +3,10 @@ title: How to Authenticate When Publishing to the Official MCP Registry sidebarTitle: Authentication --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + You must authenticate before publishing to the official MCP Registry. The MCP Registry supports different authentication methods. Which authentication method you choose determines the namespace of your server's name. If you choose GitHub-based authentication, your server's name in `server.json` **MUST** be of the form `io.github.username/*` (or `io.github.orgname/*`). For example, `io.github.alice/weather-server`. diff --git a/docs/modelcontextprotocol-io/faq.mdx b/docs/modelcontextprotocol-io/faq.mdx index 9b979d2..7493d66 100644 --- a/docs/modelcontextprotocol-io/faq.mdx +++ b/docs/modelcontextprotocol-io/faq.mdx @@ -3,6 +3,10 @@ title: Frequently Asked Questions sidebarTitle: FAQ --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + ## General ### What is the difference between "Official MCP Registry", "MCP Registry", "MCP registry", "MCP Registry API", etc? diff --git a/docs/modelcontextprotocol-io/github-actions.mdx b/docs/modelcontextprotocol-io/github-actions.mdx index aa62ef8..1ce90bc 100644 --- a/docs/modelcontextprotocol-io/github-actions.mdx +++ b/docs/modelcontextprotocol-io/github-actions.mdx @@ -3,6 +3,10 @@ title: How to Automate Publishing with GitHub Actions sidebarTitle: GitHub Actions --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + ## Step 1: Create a Workflow File In your server project directory, create a `.github/workflows/publish-mcp.yml` file. Here is an example for npm-based local server, but the MCP Registry publishing steps are the same for all package types: diff --git a/docs/modelcontextprotocol-io/moderation-policy.mdx b/docs/modelcontextprotocol-io/moderation-policy.mdx index 7800947..d31d3c8 100644 --- a/docs/modelcontextprotocol-io/moderation-policy.mdx +++ b/docs/modelcontextprotocol-io/moderation-policy.mdx @@ -3,6 +3,10 @@ title: The MCP Registry Moderation Policy sidebarTitle: Moderation Policy --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + **TL;DR**: The MCP Registry is quite permissive! We only remove illegal content, malware, spam, and completely broken servers. ## Scope diff --git a/docs/modelcontextprotocol-io/package-types.mdx b/docs/modelcontextprotocol-io/package-types.mdx index 4ce97b2..9014302 100644 --- a/docs/modelcontextprotocol-io/package-types.mdx +++ b/docs/modelcontextprotocol-io/package-types.mdx @@ -3,6 +3,10 @@ title: MCP Registry Supported Package Types sidebarTitle: Package Types --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + # Package Types The MCP Registry supports several different package types, and each package type has its own verification method. diff --git a/docs/modelcontextprotocol-io/quickstart.mdx b/docs/modelcontextprotocol-io/quickstart.mdx index 1ae3d4b..f2ae0dd 100644 --- a/docs/modelcontextprotocol-io/quickstart.mdx +++ b/docs/modelcontextprotocol-io/quickstart.mdx @@ -3,6 +3,10 @@ title: "Quickstart: Publish an MCP Server to the MCP Registry" sidebarTitle: "Quickstart: Publish a Server" --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + This tutorial will show you how to publish an MCP server written in TypeScript to the MCP Registry using the official `mcp-publisher` CLI tool. ## Prerequisites diff --git a/docs/modelcontextprotocol-io/registry-aggregators.mdx b/docs/modelcontextprotocol-io/registry-aggregators.mdx index 07ebb1e..93e30af 100644 --- a/docs/modelcontextprotocol-io/registry-aggregators.mdx +++ b/docs/modelcontextprotocol-io/registry-aggregators.mdx @@ -3,6 +3,10 @@ title: MCP Registry Aggregators sidebarTitle: Registry Aggregators --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + Aggregators are downstream consumers of the MCP Registry that provide additional value. For example, a server marketplace that provides user ratings and security scanning. The MCP Registry provides an unauthenticated read-only REST API that aggregators can use to populate their data stores. Aggregators are expected to scrape data on a regular but infrequent basis (e.g., once per hour), and persist the data in their own data store. The MCP Registry **does not provide uptime or data durability guarantees**. diff --git a/docs/modelcontextprotocol-io/remote-servers.mdx b/docs/modelcontextprotocol-io/remote-servers.mdx index 3859809..be2bdc5 100644 --- a/docs/modelcontextprotocol-io/remote-servers.mdx +++ b/docs/modelcontextprotocol-io/remote-servers.mdx @@ -3,6 +3,10 @@ title: Publishing Remote Servers sidebarTitle: Remote Servers --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + The MCP Registry supports remote MCP servers via the `remotes` property in `server.json`: ```json server.json highlight={7-12} diff --git a/docs/modelcontextprotocol-io/terms-of-service.mdx b/docs/modelcontextprotocol-io/terms-of-service.mdx index ea26afa..97b7eaf 100644 --- a/docs/modelcontextprotocol-io/terms-of-service.mdx +++ b/docs/modelcontextprotocol-io/terms-of-service.mdx @@ -3,6 +3,10 @@ title: Official MCP Registry Terms of Service sidebarTitle: Terms of Service --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + **Effective date: 2025-09-02** ## Overview diff --git a/docs/modelcontextprotocol-io/versioning.mdx b/docs/modelcontextprotocol-io/versioning.mdx index 6494077..8a7c790 100644 --- a/docs/modelcontextprotocol-io/versioning.mdx +++ b/docs/modelcontextprotocol-io/versioning.mdx @@ -3,6 +3,10 @@ title: Versioning Published MCP Servers sidebarTitle: Versioning --- + + The MCP Registry is currently in preview. Breaking changes or data resets may occur before general availability. If you encounter any issues, please report them on [GitHub](https://github.com/modelcontextprotocol/registry/issues). + + MCP servers **MUST** define a version string in `server.json`. For example: ```json server.json highlight={6}