{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "MCP Server Detail",
  "description": "Schema for a static representation of an MCP server. Used in various contexts related to discovery, installation, and configuration.",
  "type": "object",
  "required": [
    "name",
    "description",
    "version_detail"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Server name/identifier",
      "example": "io.modelcontextprotocol/filesystem"
    },
    "description": {
      "type": "string",
      "description": "Human-readable description of the server's functionality",
      "example": "Node.js server implementing Model Context Protocol (MCP) for filesystem operations."
    },
    "repository": {
      "type": "object",
      "description": "Canonical source repository information",
      "required": [
        "url",
        "source",
        "id"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Repository URL",
          "example": "https://github.com/modelcontextprotocol/servers"
        },
        "source": {
          "type": "string",
          "enum": [
            "github",
            "gitlab"
          ],
          "description": "Repository hosting service",
          "example": "github"
        },
        "id": {
          "type": "string",
          "description": "Repository identifier unique and immutable in the corresponding source",
          "example": "b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9"
        }
      }
    },
    "version_detail": {
      "type": "object",
      "description": "Version information for this server",
      "required": [
        "version",
        "release_date"
      ],
      "properties": {
        "version": {
          "type": "string",
          "description": "Server version (equivalent to Implementation.version in MCP spec)",
          "example": "1.0.2"
        },
        "release_date": {
          "type": "string",
          "format": "date-time",
          "description": "When this version was published to the registry",
          "example": "2023-06-15T10:30:00Z"
        }
      }
    },
    "packages": {
      "type": "array",
      "description": "Available package distributions",
      "items": {
        "type": "object",
        "required": [
          "registry_name",
          "name",
          "version"
        ],
        "properties": {
          "registry_name": {
            "type": "string",
            "enum": [
              "npm",
              "docker",
              "pypi",
              "homebrew"
            ],
            "description": "Package registry type",
            "example": "npm"
          },
          "name": {
            "type": "string",
            "description": "Package name in the registry",
            "example": "@modelcontextprotocol/server-filesystem"
          },
          "version": {
            "type": "string",
            "description": "Package version",
            "example": "1.0.2"
          },
          "runtime_hint": {
            "type": "string",
            "description": "Hint for appropriate runtime (e.g., npx, uvx)",
            "examples": [
              "npx",
              "uvx"
            ]
          },
          "runtime_arguments": {
            "type": "array",
            "description": "Arguments for the runtime command (docker, npx, etc.)",
            "items": {
              "$ref": "#/$defs/argument"
            }
          },
          "package_arguments": {
            "type": "array",
            "description": "Arguments for the package binary",
            "items": {
              "$ref": "#/$defs/argument"
            }
          },
          "environment_variables": {
            "type": "array",
            "description": "Environment variables to set",
            "items": {
              "$ref": "#/$defs/key_value_input"
            }
          }
        }
      }
    },
    "remotes": {
      "type": "array",
      "description": "Remote server endpoints",
      "items": {
        "type": "object",
        "required": [
          "transport_type",
          "url"
        ],
        "properties": {
          "transport_type": {
            "type": "string",
            "enum": [
              "streamable",
              "sse"
            ],
            "description": "Transport protocol type",
            "example": "sse"
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Remote server URL",
            "example": "https://mcp-fs.example.com/sse"
          },
          "headers": {
            "type": "array",
            "description": "HTTP headers to include",
            "items": {
              "$ref": "#/$defs/key_value_input"
            }
          }
        }
      }
    }
  },
  "$defs": {
    "variable_map": {
      "type": "object",
      "description": "A map of variable names to their values. Keys in the input `value` that are wrapped in `{curly_braces}` will be replaced with the corresponding variable values.",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "format": {
            "type": "string",
            "description": "Specifies the input format. Supported values include `filepath`, which should be interpreted as a file on the user's filesystem.\n\nWhen the input is converted to a string, booleans should be represented by the strings \"true\" and \"false\", and numbers should be represented as decimal values.",
            "enum": [
              "string",
              "number",
              "boolean",
              "filepath"
            ],
            "default": "string"
          },
          "is_required": {
            "type": "boolean"
          },
          "default": {
            "type": "string"
          }
        }
      }
    },
    "key_value_input": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Variable name"
        },
        "description": {
          "type": "string"
        },
        "default": {
          "type": "string"
        },
        "is_required": {
          "type": "boolean",
          "default": false
        },
        "is_secret": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "argument": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "type",
            "value_hint"
          ],
          "properties": {
            "type": {
              "const": "positional"
            },
            "value_hint": {
              "type": "string",
              "description": "An identifier-like hint for the value. This is not part of the command line, but can be used by client configuration and to provide hints to users."
            },
            "description": {
              "type": "string"
            },
            "value": {
              "type": "string",
              "description": "The default value for the input. If this is not set, the user may be prompted to provide a value.\n\nIdentifiers wrapped in `{curly_braces}` will be replaced with the corresponding properties from the input `variables` map. If an identifier in braces is not found in `variables`, or if `variables` is not provided, the `{curly_braces}` substring should remain unchanged."
            },
            "default": {
              "type": "string"
            },
            "is_required": {
              "type": "boolean",
              "default": false
            },
            "is_repeated": {
              "type": "boolean",
              "default": false
            },
            "variables": {
              "$ref": "#/$defs/variable_map"
            }
          }
        },
        {
          "type": "object",
          "required": [
            "type",
            "name"
          ],
          "properties": {
            "type": {
              "const": "named"
            },
            "name": {
              "type": "string",
              "description": "Flag name including dashes"
            },
            "description": {
              "type": "string"
            },
            "value": {
              "type": "string",
              "description": "The default value for the input. If this is not set, the user may be prompted to provide a value.\n\nIdentifiers wrapped in `{curly_braces}` will be replaced with the corresponding properties from the input `variables` map. If an identifier in braces is not found in `variables`, or if `variables` is not provided, the `{curly_braces}` substring should remain unchanged."
            },
            "is_required": {
              "type": "boolean",
              "default": false
            },
            "is_repeated": {
              "type": "boolean",
              "default": false
            },
            "variables": {
              "$ref": "#/$defs/variable_map"
            }
          }
        }
      ]
    }
  }
}