Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions docs/reference/api/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ A standardized way for registries to provide experimental or community-driven fe

## URL Structure

Extensions live under the `/v0/x/` prefix:
Extensions live under the `/v0.1/x/` prefix:

```
/v0/x/<namespace>/<extension>[/<path>]
/v0.1/x/<namespace>/<extension>[/<path>]
```

**Components:**
Expand All @@ -26,9 +26,9 @@ Extensions live under the `/v0/x/` prefix:

**Examples:**
```
/v0/x/com.example/search?q=database
/v0/x/com.example/stats
/v0/x/io.github.username/custom-feature
/v0.1/x/com.example/search?q=database
/v0.1/x/com.example/stats
/v0.1/x/io.github.username/custom-feature
```

## Conventions
Expand All @@ -50,7 +50,7 @@ Clients consuming extensions **MUST** gracefully handle missing extensions.
A simple server stats extension:

```bash
GET /v0/x/com.example/stats
GET /v0.1/x/com.example/stats
```

```json
Expand All @@ -63,7 +63,7 @@ GET /v0/x/com.example/stats

## Future Considerations

- **Extension discovery**: A potential `/v0/x` endpoint to list available extensions
- **Extension discovery**: A potential `/v0.1/x` endpoint to list available extensions
- **Extension metadata**: Standardized metadata format for extension capabilities
- **Defining common extensions**: Like semantic conventions from OpenTelemetry, develop common extensions that registries can adopt (possibly under an experimental namespace)
- Search extension for free-text search across server metadata ([#389](https://github.com/modelcontextprotocol/registry/issues/389))
Expand Down
13 changes: 6 additions & 7 deletions docs/reference/api/openapi.yaml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
openapi: 3.1.0
jsonSchemaDialect: "https://json-schema.org/draft/2020-12/schema"
$id: https://modelcontextprotocol.io/schemas/draft/2025-10-17/server-registry-openapi
$id: https://modelcontextprotocol.io/schemas/draft/2025-12-01/server-registry-openapi
info:
title: MCP Server Registry API
version: "2025-10-17"
version: "2025-12-01"
summary: API for discovering and accessing MCP server metadata
description: |
Specification for a theoretical REST API that serves up metadata about MCP servers.
Expand All @@ -18,7 +18,7 @@ tags:
description: Operations for publishing MCP servers to the registry

paths:
/v0/servers:
/v0.1/servers:
get:
tags: [servers]
summary: List MCP servers
Expand Down Expand Up @@ -68,7 +68,7 @@ paths:
application/json:
schema:
$ref: '#/components/schemas/ServerList'
/v0/servers/{serverName}/versions:
/v0.1/servers/{serverName}/versions:
get:
tags: [servers]
summary: List all versions of an MCP server
Expand Down Expand Up @@ -98,7 +98,7 @@ paths:
error:
type: string
example: "Server not found"
/v0/servers/{serverName}/versions/{version}:
/v0.1/servers/{serverName}/versions/{version}:
get:
tags: [servers]
summary: Get specific MCP server version
Expand Down Expand Up @@ -218,7 +218,7 @@ paths:
error:
type: string
example: "Deletion is not supported by this registry"
/v0/publish:
/v0.1/publish:
post:
tags: [publish]
summary: Publish MCP server (Optional)
Expand Down Expand Up @@ -741,7 +741,6 @@ components:
type: object
required:
- server
- _meta
properties:
server:
$ref: '#/components/schemas/ServerDetail'
Expand Down
Loading