modelcontextprotocol/registry
Watch
1
0
Fork
You've already forked registry
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: update API endpoint documentation from /v0/ to /v0.1/ (#802)

Browse source 
Update all documentation to reference the stable `/v0.1/` API version
instead of the development `/v0/` version.

Didn't update internal references (e.g. in admin-only docs) as that
probably make sense to keep pointed at v0 as the "dev" option.

Authored by Claude Code, reviewed by me.

---------

Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Tadas Antanavicius 2025-12-04 13:02:45 -08:00 • committed by GitHub
commit 65b96b03ce
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 21 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/design/tech-architecture.md
View file

@ -177,7 +177,7 @@ sequenceDiagram
Admin->>CLI: Request admin token Admin->>CLI: Request admin token
CLI->>GCP: gcloud auth print-identity-token --audiences=mcp-registry CLI->>GCP: gcloud auth print-identity-token --audiences=mcp-registry
GCP-->>CLI: ID Token (with hd: "modelcontextprotocol.io") GCP-->>CLI: ID Token (with hd: "modelcontextprotocol.io")
CLI->>API: POST /v0/auth/oidc {"oidc_token": "eyJ..."} CLI->>API: POST /v0.1/auth/oidc {"oidc_token": "eyJ..."}
API->>GCP: Verify token signature (JWKS) API->>GCP: Verify token signature (JWKS)
API->>API: Validate claims (issuer, audience, hd) API->>API: Validate claims (issuer, audience, hd)
API->>API: Grant admin permissions (edit: *, publish: *) API->>API: Grant admin permissions (edit: *, publish: *)
@ -193,10 +193,10 @@ sequenceDiagram
ID_TOKEN=$(gcloud auth print-identity-token) ID_TOKEN=$(gcloud auth print-identity-token)
# Exchange for Registry JWT token # Exchange for Registry JWT token
REGISTRY_TOKEN=$(curl -X POST /v0/auth/oidc \ REGISTRY_TOKEN=$(curl -X POST /v0.1/auth/oidc \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
-d '{"oidc_token": "'$ID_TOKEN'"}' | jq -r .registry_token) -d '{"oidc_token": "'$ID_TOKEN'"}' | jq -r .registry_token)
# Use for admin operations # Use for admin operations
curl -H "Authorization: Bearer $REGISTRY_TOKEN" /v0/... curl -H "Authorization: Bearer $REGISTRY_TOKEN" /v0.1/...
``` ```

4
docs/modelcontextprotocol-io/registry-aggregators.mdx
View file

@ -30,7 +30,7 @@ The `GET /v0.1/servers` endpoint supports cursor-based pagination.
For example, the first page can be fetched using a `limit` query parameter: For example, the first page can be fetched using a `limit` query parameter:
```bash ```bash
curl "https://registry.modelcontextprotocol.io/v0/servers?limit=100" curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100"
``` ```
```jsonc Output highlight={5} ```jsonc Output highlight={5}
@ -48,7 +48,7 @@ curl "https://registry.modelcontextprotocol.io/v0/servers?limit=100"
Then subsequent pages can be fetched by passing the `nextCursor` value as the `cursor` query parameter: Then subsequent pages can be fetched by passing the `nextCursor` value as the `cursor` query parameter:
```bash ```bash
curl "https://registry.modelcontextprotocol.io/v0/servers?limit=100&cursor=com.example/my-server:1.0.0" curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100&cursor=com.example/my-server:1.0.0"
``` ```
### Filtering Since ### Filtering Since

12
docs/reference/api/generic-registry-api.md
View file

@ -14,11 +14,11 @@ The official registry has some more endpoints and restrictions on top of this. S
## Quick Reference ## Quick Reference
### Core Endpoints ### Core Endpoints
- **`GET /v0/servers`** - List all servers with pagination - **`GET /v0.1/servers`** - List all servers with pagination
- **`GET /v0/servers/{serverName}/versions`** - List all versions of a server - **`GET /v0.1/servers/{serverName}/versions`** - List all versions of a server
- **`GET /v0/servers/{serverName}/versions/{version}`** - Get specific version of server. Use the special version `latest` to get the latest version. - **`GET /v0.1/servers/{serverName}/versions/{version}`** - Get specific version of server. Use the special version `latest` to get the latest version.
- **`POST /v0/publish`** - Publish new server (optional, registry-specific authentication) - **`POST /v0.1/publish`** - Publish new server (optional, registry-specific authentication)
- **`DELETE /v0/servers/{serverName}/versions/{version}`** - Delete specific server version (optional, not implemented by official registry) - **`DELETE /v0.1/servers/{serverName}/versions/{version}`** - Delete specific server version (optional, not implemented by official registry)
Server names and version strings should be URL-encoded in paths. Server names and version strings should be URL-encoded in paths.
@ -42,7 +42,7 @@ List endpoints use cursor-based pagination for efficient, stable results.
### Basic Example: List Servers ### Basic Example: List Servers
```bash ```bash
curl https://registry.example.com/v0/servers?limit=10 curl https://registry.example.com/v0.1/servers?limit=10
``` ```
```json ```json

18
docs/reference/api/official-registry-api.md
View file

@ -35,7 +35,7 @@ The official registry enforces additional [package validation requirements](../s
### Server List Filtering ### Server List Filtering
The official registry extends the `GET /v0/servers` endpoint with additional query parameters for improved discovery and synchronization: The official registry extends the `GET /v0.1/servers` endpoint with additional query parameters for improved discovery and synchronization:
- `updated_since` - Filter servers updated after RFC3339 timestamp (e.g., `2025-08-07T13:15:04.280Z`) - `updated_since` - Filter servers updated after RFC3339 timestamp (e.g., `2025-08-07T13:15:04.280Z`)
- `search` - Case-insensitive substring search on server names (e.g., `filesystem`) - `search` - Case-insensitive substring search on server names (e.g., `filesystem`)
@ -44,18 +44,18 @@ The official registry extends the `GET /v0/servers` endpoint with additional que
These extensions enable efficient incremental synchronization for downstream registries and improved server discovery. Parameters can be combined and work with standard cursor-based pagination. These extensions enable efficient incremental synchronization for downstream registries and improved server discovery. Parameters can be combined and work with standard cursor-based pagination.
Example: `GET /v0/servers?search=filesystem&updated_since=2025-08-01T00:00:00Z&version=latest` Example: `GET /v0.1/servers?search=filesystem&updated_since=2025-08-01T00:00:00Z&version=latest`
### Additional endpoints ### Additional endpoints
#### Auth endpoints #### Auth endpoints
- POST `/v0/auth/dns` - Exchange signed DNS challenge for auth token - POST `/v0.1/auth/dns` - Exchange signed DNS challenge for auth token
- POST `/v0/auth/http` - Exchange signed HTTP challenge for auth token - POST `/v0.1/auth/http` - Exchange signed HTTP challenge for auth token
- POST `/v0/auth/github-at` - Exchange GitHub access token for auth token - POST `/v0.1/auth/github-at` - Exchange GitHub access token for auth token
- POST `/v0/auth/github-oidc` - Exchange GitHub OIDC token for auth token - POST `/v0.1/auth/github-oidc` - Exchange GitHub OIDC token for auth token
- POST `/v0/auth/oidc` - Exchange Google OIDC token for auth token (for admins) - POST `/v0.1/auth/oidc` - Exchange Google OIDC token for auth token (for admins)
#### Admin endpoints #### Admin endpoints
- GET `/metrics` - Prometheus metrics endpoint - GET `/metrics` - Prometheus metrics endpoint
- GET `/v0/health` - Basic health check endpoint - GET `/v0.1/health` - Basic health check endpoint
- PUT `/v0/servers/{serverName}/versions/{version}` - Edit specific server version - PUT `/v0.1/servers/{serverName}/versions/{version}` - Edit specific server version

2
scripts/mirror_data/README.md
View file

@ -31,7 +31,7 @@ go run scripts/mirror_data/fetch_production_data.go
``` ```
This will: This will:
- Fetch all servers from https://registry.modelcontextprotocol.io/v0/servers - Fetch all servers from https://registry.modelcontextprotocol.io/v0.1/servers
- Handle pagination automatically - Handle pagination automatically
- Save data to `scripts/mirror_data/production_servers.json` - Save data to `scripts/mirror_data/production_servers.json`
- Be respectful to the API with rate limiting - Be respectful to the API with rate limiting