Skip to content

Commit 6972e54

Browse files
tadasantclaude
andauthored
docs: remove status field from server.json examples (#575)
## Summary - Remove the `status` field from all server.json examples in documentation - Remove the deprecated server example that was primarily about demonstrating the status field - Update example count validation from 13 to 12 ## Context The `status` field was removed from the server.json schema in commit b21c6f5 (#562). This PR cleans up the documentation to reflect that change. ## Why didn't tests catch this? The schema validation didn't catch the invalid `status` field because the JSON schema doesn't have `additionalProperties: false` set. This means the schema allows arbitrary additional properties by default. ## Test plan - [x] All validation checks pass (`make check`) - [x] Example count updated to match the new total (12 examples) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <noreply@anthropic.com>
1 parent a0117a6 commit 6972e54

File tree

2 files changed

+5
-56
lines changed

2 files changed

+5
-56
lines changed

docs/reference/server-json/generic-server-json.md

Lines changed: 0 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,6 @@ The official registry has some more restrictions on top of this. See the [offici
2525
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
2626
"name": "io.modelcontextprotocol.anonymous/brave-search",
2727
"description": "MCP server for Brave Search API integration",
28-
"status": "active",
2928
"websiteUrl": "https://anonymous.modelcontextprotocol.io/examples",
3029
"repository": {
3130
"url": "https://github.com/modelcontextprotocol/servers",
@@ -72,7 +71,6 @@ For MCP servers located within a subdirectory of a larger repository (monorepo s
7271
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
7372
"name": "io.modelcontextprotocol/everything",
7473
"description": "MCP server that exercises all the features of the MCP protocol",
75-
"status": "active",
7674
"repository": {
7775
"url": "https://github.com/modelcontextprotocol/servers",
7876
"source": "github",
@@ -154,7 +152,6 @@ This will essentially instruct the MCP client to execute `dnx Knapcode.SampleMcp
154152
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
155153
"name": "io.github.modelcontextprotocol/filesystem",
156154
"description": "Node.js server implementing Model Context Protocol (MCP) for filesystem operations.",
157-
"status": "active",
158155
"repository": {
159156
"url": "https://github.com/modelcontextprotocol/servers",
160157
"source": "github",
@@ -629,7 +626,6 @@ Some CLI tools bundle an MCP server, without a standalone MCP package or a publi
629626
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
630627
"name": "io.snyk/cli-mcp",
631628
"description": "MCP server provided by the Snyk CLI",
632-
"status": "active",
633629
"version": "1.1298.0",
634630
"packages": [
635631
{
@@ -664,55 +660,8 @@ For MCP servers that follow a custom installation path or are embedded in applic
664660
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
665661
"name": "io.modelcontextprotocol.anonymous/embedded-mcp",
666662
"description": "MCP server embedded in a Desktop app",
667-
"status": "active",
668663
"websiteUrl": "https://anonymous.modelcontextprotocol.io/embedded-mcp-guide",
669664
"version": "0.1.0"
670665
}
671666
```
672667

673-
### Deprecated Server Example
674-
675-
```json
676-
{
677-
"name": "io.github.example/old-weather",
678-
"description": "Legacy weather server - DEPRECATED: Use weather-v2 instead for new projects",
679-
"status": "deprecated",
680-
"repository": {
681-
"url": "https://github.com/example/old-weather",
682-
"source": "github",
683-
"id": "legacy-abc123-def456-789012-345678-901234567890"
684-
},
685-
"version": "0.9.5",
686-
"packages": [
687-
{
688-
"registryType": "npm",
689-
"registryBaseUrl": "https://registry.npmjs.org",
690-
"identifier": "@legacy/old-weather-server",
691-
"version": "0.9.5",
692-
"transport": {
693-
"type": "stdio"
694-
},
695-
"environmentVariables": [
696-
{
697-
"name": "WEATHER_API_KEY",
698-
"description": "Weather API key",
699-
"isRequired": true,
700-
"isSecret": true
701-
}
702-
]
703-
}
704-
],
705-
"_meta": {
706-
"io.modelcontextprotocol.registry/publisher-provided": {
707-
"tool": "legacy-publisher",
708-
"version": "0.8.1",
709-
"build_info": {
710-
"timestamp": "2023-06-15T09:30:00Z",
711-
"deprecation_notice": "This publisher is deprecated. Use npm-publisher v2.0+ for new projects.",
712-
"maintenance_mode": true,
713-
"final_version": true
714-
}
715-
}
716-
}
717-
}
718-
```

tools/validate-examples/main.go

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ import (
1818
)
1919

2020
type validationTarget struct {
21-
path string
22-
requireSchema bool
23-
expectedCount *int
21+
path string
22+
requireSchema bool
23+
expectedCount *int
2424
}
2525

2626
func main() {
@@ -33,7 +33,7 @@ func main() {
3333

3434
func runValidation() error {
3535
// Define what we validate and how
36-
expectedServerJSONCount := 13
36+
expectedServerJSONCount := 12
3737
targets := []validationTarget{
3838
{
3939
path: filepath.Join("docs", "reference", "server-json", "generic-server-json.md"),
@@ -227,4 +227,4 @@ func compileSchema(path string) (*jsonschema.Schema, error) {
227227
}
228228

229229
return compiler.Compile(path)
230-
}
230+
}

0 commit comments

Comments
 (0)