Skip to content

Commit 65b96b0

Browse files
tadasantclaude
andauthored
docs: update API endpoint documentation from /v0/ to /v0.1/ (#802)
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>
1 parent d092dd6 commit 65b96b0

File tree

5 files changed

+21
-21
lines changed

5 files changed

+21
-21
lines changed

docs/design/tech-architecture.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ sequenceDiagram
177177
Admin->>CLI: Request admin token
178178
CLI->>GCP: gcloud auth print-identity-token --audiences=mcp-registry
179179
GCP-->>CLI: ID Token (with hd: "modelcontextprotocol.io")
180-
CLI->>API: POST /v0/auth/oidc {"oidc_token": "eyJ..."}
180+
CLI->>API: POST /v0.1/auth/oidc {"oidc_token": "eyJ..."}
181181
API->>GCP: Verify token signature (JWKS)
182182
API->>API: Validate claims (issuer, audience, hd)
183183
API->>API: Grant admin permissions (edit: *, publish: *)
@@ -193,10 +193,10 @@ sequenceDiagram
193193
ID_TOKEN=$(gcloud auth print-identity-token)
194194

195195
# Exchange for Registry JWT token
196-
REGISTRY_TOKEN=$(curl -X POST /v0/auth/oidc \
196+
REGISTRY_TOKEN=$(curl -X POST /v0.1/auth/oidc \
197197
-H "Content-Type: application/json" \
198198
-d '{"oidc_token": "'$ID_TOKEN'"}' | jq -r .registry_token)
199199

200200
# Use for admin operations
201-
curl -H "Authorization: Bearer $REGISTRY_TOKEN" /v0/...
201+
curl -H "Authorization: Bearer $REGISTRY_TOKEN" /v0.1/...
202202
```

docs/modelcontextprotocol-io/registry-aggregators.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ The `GET /v0.1/servers` endpoint supports cursor-based pagination.
3030
For example, the first page can be fetched using a `limit` query parameter:
3131

3232
```bash
33-
curl "https://registry.modelcontextprotocol.io/v0/servers?limit=100"
33+
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100"
3434
```
3535

3636
```jsonc Output highlight={5}
@@ -48,7 +48,7 @@ curl "https://registry.modelcontextprotocol.io/v0/servers?limit=100"
4848
Then subsequent pages can be fetched by passing the `nextCursor` value as the `cursor` query parameter:
4949

5050
```bash
51-
curl "https://registry.modelcontextprotocol.io/v0/servers?limit=100&cursor=com.example/my-server:1.0.0"
51+
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100&cursor=com.example/my-server:1.0.0"
5252
```
5353

5454
### Filtering Since

docs/reference/api/generic-registry-api.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ The official registry has some more endpoints and restrictions on top of this. S
1414
## Quick Reference
1515

1616
### Core Endpoints
17-
- **`GET /v0/servers`** - List all servers with pagination
18-
- **`GET /v0/servers/{serverName}/versions`** - List all versions of a server
19-
- **`GET /v0/servers/{serverName}/versions/{version}`** - Get specific version of server. Use the special version `latest` to get the latest version.
20-
- **`POST /v0/publish`** - Publish new server (optional, registry-specific authentication)
21-
- **`DELETE /v0/servers/{serverName}/versions/{version}`** - Delete specific server version (optional, not implemented by official registry)
17+
- **`GET /v0.1/servers`** - List all servers with pagination
18+
- **`GET /v0.1/servers/{serverName}/versions`** - List all versions of a server
19+
- **`GET /v0.1/servers/{serverName}/versions/{version}`** - Get specific version of server. Use the special version `latest` to get the latest version.
20+
- **`POST /v0.1/publish`** - Publish new server (optional, registry-specific authentication)
21+
- **`DELETE /v0.1/servers/{serverName}/versions/{version}`** - Delete specific server version (optional, not implemented by official registry)
2222

2323
Server names and version strings should be URL-encoded in paths.
2424

@@ -42,7 +42,7 @@ List endpoints use cursor-based pagination for efficient, stable results.
4242
### Basic Example: List Servers
4343

4444
```bash
45-
curl https://registry.example.com/v0/servers?limit=10
45+
curl https://registry.example.com/v0.1/servers?limit=10
4646
```
4747

4848
```json

docs/reference/api/official-registry-api.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The official registry enforces additional [package validation requirements](../s
3535

3636
### Server List Filtering
3737

38-
The official registry extends the `GET /v0/servers` endpoint with additional query parameters for improved discovery and synchronization:
38+
The official registry extends the `GET /v0.1/servers` endpoint with additional query parameters for improved discovery and synchronization:
3939

4040
- `updated_since` - Filter servers updated after RFC3339 timestamp (e.g., `2025-08-07T13:15:04.280Z`)
4141
- `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
4444

4545
These extensions enable efficient incremental synchronization for downstream registries and improved server discovery. Parameters can be combined and work with standard cursor-based pagination.
4646

47-
Example: `GET /v0/servers?search=filesystem&updated_since=2025-08-01T00:00:00Z&version=latest`
47+
Example: `GET /v0.1/servers?search=filesystem&updated_since=2025-08-01T00:00:00Z&version=latest`
4848

4949
### Additional endpoints
5050

5151
#### Auth endpoints
52-
- POST `/v0/auth/dns` - Exchange signed DNS challenge for auth token
53-
- POST `/v0/auth/http` - Exchange signed HTTP challenge for auth token
54-
- POST `/v0/auth/github-at` - Exchange GitHub access token for auth token
55-
- POST `/v0/auth/github-oidc` - Exchange GitHub OIDC token for auth token
56-
- POST `/v0/auth/oidc` - Exchange Google OIDC token for auth token (for admins)
52+
- POST `/v0.1/auth/dns` - Exchange signed DNS challenge for auth token
53+
- POST `/v0.1/auth/http` - Exchange signed HTTP challenge for auth token
54+
- POST `/v0.1/auth/github-at` - Exchange GitHub access token for auth token
55+
- POST `/v0.1/auth/github-oidc` - Exchange GitHub OIDC token for auth token
56+
- POST `/v0.1/auth/oidc` - Exchange Google OIDC token for auth token (for admins)
5757

5858
#### Admin endpoints
5959
- GET `/metrics` - Prometheus metrics endpoint
60-
- GET `/v0/health` - Basic health check endpoint
61-
- PUT `/v0/servers/{serverName}/versions/{version}` - Edit specific server version
60+
- GET `/v0.1/health` - Basic health check endpoint
61+
- PUT `/v0.1/servers/{serverName}/versions/{version}` - Edit specific server version

scripts/mirror_data/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ go run scripts/mirror_data/fetch_production_data.go
3131
```
3232

3333
This will:
34-
- Fetch all servers from https://registry.modelcontextprotocol.io/v0/servers
34+
- Fetch all servers from https://registry.modelcontextprotocol.io/v0.1/servers
3535
- Handle pagination automatically
3636
- Save data to `scripts/mirror_data/production_servers.json`
3737
- Be respectful to the API with rate limiting

0 commit comments

Comments
 (0)