Skip to content

Commit 59e9d4f

Browse files
authored
Merge pull request modelcontextprotocol#2380 from wong2/fix-registry-internal-links
Fix registry internal links by removing `.mdx` suffixes
2 parents 9946440 + 5abdf44 commit 59e9d4f

4 files changed

Lines changed: 11 additions & 11 deletions

File tree

docs/registry/about.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ The MCP Registry hosts metadata that points to those packages.
3737

3838
For example, a `weather-mcp` package could be hosted on npm, and metadata in the MCP Registry could map the "weather v1.2.0" server to `npm:weather-mcp`.
3939

40-
The [Package Types guide](./package-types.mdx) lists the supported package types and registries. More package registries may be supported in the future based on community demand. If you are interested in building support for a package registry, please [open an issue](https://github.com/modelcontextprotocol/registry).
40+
The [Package Types guide](./package-types) lists the supported package types and registries. More package registries may be supported in the future based on community demand. If you are interested in building support for a package registry, please [open an issue](https://github.com/modelcontextprotocol/registry).
4141

4242
### Relationship with Server Developers
4343

@@ -51,7 +51,7 @@ The MCP Registry is intended to be consumed primarily by downstream aggregators,
5151

5252
The metadata hosted by the MCP Registry is deliberately unopinionated. Downstream aggregators can provide curation or additional metadata such as community ratings.
5353

54-
We expect that downstream aggregators will use the MCP Registry API to pull new metadata on a regular but infrequent basis (for example, once per hour). See the [MCP Registry Aggregators guide](./registry-aggregators.mdx) for more information.
54+
We expect that downstream aggregators will use the MCP Registry API to pull new metadata on a regular but infrequent basis (for example, once per hour). See the [MCP Registry Aggregators guide](./registry-aggregators) for more information.
5555

5656
### Relationship with Other MCP Registries
5757

@@ -71,7 +71,7 @@ The MCP Registry is not intended to be directly consumed by host applications. I
7171

7272
The MCP Registry uses namespace authentication to ensure that servers come from their claimed sources. Server names follow a reverse DNS format (like `io.github.username/server` or `com.example/server`) that ties them to verified GitHub accounts or domains.
7373

74-
This namespace system ensures that only the legitimate owner of a GitHub account or domain can publish servers under that namespace, providing trust and accountability in the ecosystem. For details on authentication methods, see the [Authentication guide](./authentication.mdx).
74+
This namespace system ensures that only the legitimate owner of a GitHub account or domain can publish servers under that namespace, providing trust and accountability in the ecosystem. For details on authentication methods, see the [Authentication guide](./authentication).
7575

7676
### Security Scanning
7777

@@ -88,6 +88,6 @@ The MCP Registry uses multiple mechanisms to prevent spam:
8888

8989
- **Namespace authentication requirements** — Publishers must verify ownership of their namespace through GitHub, DNS, or HTTP challenges, preventing arbitrary spam submissions.
9090
- **Character limits and validation** — Free-form fields have strict character limits and regex validation to prevent abuse.
91-
- **Manual takedown** — The registry maintainers can manually remove spam or malicious servers. See the [Moderation Policy](./moderation-policy.mdx) for details on what content is removed.
91+
- **Manual takedown** — The registry maintainers can manually remove spam or malicious servers. See the [Moderation Policy](./moderation-policy) for details on what content is removed.
9292

9393
Future spam prevention measures under consideration include stricter rate limiting, AI-based spam detection, and community reporting capabilities.

docs/registry/github-actions.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,6 @@ The workflow will run tests, build the package, publish the package to npm, and
220220
| Error Message | Action |
221221
| --- | --- |
222222
| "Authentication failed" | Ensure `id-token: write` permission is set for OIDC, or check secrets. |
223-
| "Package validation failed" | Verify your package successfully published to the package registry (e.g., npm, PyPI), and that your package has the [necessary verification information](./package-types.mdx). |
223+
| "Package validation failed" | Verify your package successfully published to the package registry (e.g., npm, PyPI), and that your package has the [necessary verification information](./package-types). |
224224

225225
{/* prettier-ignore-end */}

docs/registry/quickstart.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This tutorial will show you how to publish an MCP server written in TypeScript t
1313

1414
- **Node.js** — This tutorial assumes the MCP server is written in TypeScript.
1515
- **npm account** — The MCP Registry only hosts metadata, not artifacts. Before publishing to the MCP Registry, we will publish the MCP server's package to npm, so you will need an [npm](https://www.npmjs.com) account.
16-
- **GitHub account** — The MCP Registry supports [multiple authentication methods](./authentication.mdx). For simplicity, this tutorial will use GitHub-based authentication, so you will need a [GitHub](https://github.com/) account.
16+
- **GitHub account** — The MCP Registry supports [multiple authentication methods](./authentication). For simplicity, this tutorial will use GitHub-based authentication, so you will need a [GitHub](https://github.com/) account.
1717

1818
If you do not have an MCP server written in TypeScript, you can copy the `weather-server-typescript` server from the [`modelcontextprotocol/quickstart-resources` repository](https://github.com/modelcontextprotocol/quickstart-resources) to follow along with this tutorial:
1919

@@ -287,7 +287,7 @@ You should see your server's metadata in the search results JSON:
287287

288288
## Next Steps
289289

290-
- Learn about [support for other package types](./package-types.mdx).
291-
- Learn about [support for remote servers](./remote-servers.mdx).
292-
- Learn how to [use other authentication methods](./authentication.mdx), such as [DNS authentication](./authentication.mdx#dns-authentication) which enables custom domains for server name prefixes.
293-
- Learn how to [automate publishing with GitHub Actions](./github-actions.mdx).
290+
- Learn about [support for other package types](./package-types).
291+
- Learn about [support for remote servers](./remote-servers).
292+
- Learn how to [use other authentication methods](./authentication), such as [DNS authentication](./authentication#dns-authentication) which enables custom domains for server name prefixes.
293+
- Learn how to [automate publishing with GitHub Actions](./github-actions).

docs/registry/registry-aggregators.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ curl "https://registry.modelcontextprotocol.io/v0.1/servers?updated_since=2025-1
6969

7070
Server metadata is generally immutable, except for the `status` field which may be updated to, e.g., `"deprecated"` or `"deleted"`. We recommend that aggregators keep their copy of each server's `status` up to date.
7171

72-
The `"deleted"` status typically indicates that a server has violated our permissive [moderation policy](./moderation-policy.mdx), suggesting the server might be spam, malware, or illegal. Aggregators may prefer to remove these servers from their index.
72+
The `"deleted"` status typically indicates that a server has violated our permissive [moderation policy](./moderation-policy), suggesting the server might be spam, malware, or illegal. Aggregators may prefer to remove these servers from their index.
7373

7474
## Acting as a Subregistry
7575

0 commit comments

Comments
 (0)