---
title: "ServerDetail"
url: "https://nov18-dev.movespot.fyi/apis/internal-mcp-server-registry-v0-and-mcp-servers-on-v0-and-v0-1-dev-1/versions/6ba164e8-2493-49de-a378-11495c33f243/schemas/ServerDetail"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/internal-mcp-server-registry-v0-and-mcp-servers-on-v0-and-v0-1-dev-1/versions/6ba164e8-2493-49de-a378-11495c33f243.md

# ServerDetail

Schema for a static representation of an MCP server. Used in various contexts related to discovery, installation, and configuration.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Internal MCP Server Registry v0 and MCP servers on v0 and v0.1
  version: 1.1.0
servers:
  - url: https://us.api.konghq.com/v0
    description: United-States Production region
  - url: https://eu.api.konghq.com/v0
    description: Europe Production region
  - url: https://au.api.konghq.com/v0
    description: Australia Production region
  - url: https://me.api.konghq.com/v0
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v0
    description: India Production region
  - url: https://sg.api.konghq.com/v0
    description: Singapore Production region
components:
  schemas:
    Repository:
      description: Repository metadata for the MCP server source code. Enables users
        and security experts to inspect the code, improving transparency.
      type: object
      properties:
        url:
          description: Repository URL for browsing source code. Should support both web
            browsing and git clone operations.
          type: string
          format: uri
          example: https://github.com/modelcontextprotocol/servers
        source:
          description: Repository hosting service identifier. Used by registries to
            determine validation and API access methods.
          type: string
          example: github
        id:
          description: "Repository identifier from the hosting service (e.g., GitHub repo
            ID). Owned and determined by the source forge. Should remain stable
            across repository renames and may be used to detect repository
            resurrection attacks - if a repository is deleted and recreated, the
            ID should change. For GitHub, use: gh api repos/<owner>/<repo> --jq
            '.id'"
          type: string
          example: b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9
        subfolder:
          description: Optional relative path from repository root to the server location
            within a monorepo or nested package structure. Must be a clean
            relative path.
          type: string
          example: src/everything
      required:
        - url
        - source
    Icon:
      description: An optionally-sized icon that can be displayed in a user interface.
      type: object
      properties:
        src:
          description: A standard URI pointing to an icon resource. Must be an HTTPS URL.
            Consumers SHOULD take steps to ensure URLs serving icons are from
            the same domain as the server or a trusted domain. Consumers SHOULD
            take appropriate precautions when consuming SVGs as they can contain
            executable JavaScript.
          type: string
          format: uri
          example: https://example.com/icon.png
          maxLength: 255
        mimeType:
          description: "Optional MIME type override if the source MIME type is missing or
            generic. Must be one of: image/png, image/jpeg, image/jpg,
            image/svg+xml, image/webp."
          type: string
          example: image/png
          enum:
            - image/png
            - image/jpeg
            - image/jpg
            - image/svg+xml
            - image/webp
        sizes:
          description: Optional array of strings that specify sizes at which the icon can
            be used. Each string should be in WxH format (e.g., '48x48',
            '96x96') or 'any' for scalable formats like SVG. If not provided,
            the client should assume that the icon can be used at any size.
          type: array
          items:
            type: string
            pattern: ^(\d+x\d+|any)$
          example:
            - 48x48
            - 96x96
        theme:
          description: Optional specifier for the theme this icon is designed for. 'light'
            indicates the icon is designed to be used with a light background,
            and 'dark' indicates the icon is designed to be used with a dark
            background. If not provided, the client should assume the icon can
            be used with any theme.
          type: string
          enum:
            - light
            - dark
      required:
        - src
    Package:
      type: object
      properties:
        registryType:
          description: Registry type indicating how to download packages (e.g., 'npm',
            'pypi', 'oci', 'nuget', 'mcpb')
          type: string
          example: npm
        registryBaseUrl:
          description: Base URL of the package registry
          type: string
          format: uri
          example: https://registry.npmjs.org
        identifier:
          description: Package identifier - either a package name (for registries) or URL
            (for direct downloads)
          type: string
          example: "@modelcontextprotocol/server-brave-search"
        version:
          description: Package version. Must be a specific version. Version ranges are
            rejected (e.g., '^1.2.3', '~1.2.3', '>=1.2.3', '1.x', '1.*').
          type: string
          example: 1.0.2
          minLength: 1
          not:
            enum:
              - latest
        fileSha256:
          description: SHA-256 hash of the package file for integrity verification.
            Required for MCPB packages and optional for other package types.
            Authors are responsible for generating correct SHA-256 hashes when
            creating server.json. If present, MCP clients must validate the
            downloaded file matches the hash before running packages to ensure
            file integrity.
          type: string
          example: fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce
          pattern: ^[a-f0-9]{64}$
        runtimeHint:
          description: A hint to help clients determine the appropriate runtime for the
            package. This field should be provided when `runtimeArguments` are
            present.
          type: string
          example: npx
        transport:
          allOf:
            - $ref: "#/components/schemas/LocalTransport"
            - description: Transport protocol configuration for the package
        runtimeArguments:
          description: A list of arguments to be passed to the package's runtime command
            (such as docker or npx). The `runtimeHint` field should be provided
            when `runtimeArguments` are present.
          type: array
          items:
            $ref: "#/components/schemas/Argument"
        packageArguments:
          description: A list of arguments to be passed to the package's binary.
          type: array
          items:
            $ref: "#/components/schemas/Argument"
        environmentVariables:
          description: A mapping of environment variables to be set when running the
            package.
          type: array
          items:
            $ref: "#/components/schemas/KeyValueInput"
      required:
        - registryType
        - identifier
        - transport
    RemoteTransport:
      description: Transport protocol configuration for remote context - extends
        StreamableHttpTransport or SseTransport with variables
      allOf:
        - anyOf:
            - $ref: "#/components/schemas/StreamableHttpTransport"
            - $ref: "#/components/schemas/SseTransport"
        - type: object
          properties:
            variables:
              description: Configuration variables that can be referenced in URL template
                {curly_braces}. The key is the variable name, and the value
                defines the variable properties.
              type: object
              additionalProperties:
                $ref: "#/components/schemas/Input"
    LocalTransport:
      description: Transport protocol configuration for local/package context
      anyOf:
        - $ref: "#/components/schemas/StdioTransport"
        - $ref: "#/components/schemas/StreamableHttpTransport"
        - $ref: "#/components/schemas/SseTransport"
    Argument:
      description: "Warning: Arguments construct command-line parameters that may
        contain user-provided input. This creates potential command injection
        risks if clients execute commands in a shell environment. For example, a
        malicious argument value like ';rm -rf ~/Development' could execute
        dangerous commands. Clients should prefer non-shell execution methods
        (e.g., posix_spawn) when possible to eliminate injection risks entirely.
        Where not possible, clients should obtain consent from users or agents
        to run the resolved command before execution."
      anyOf:
        - $ref: "#/components/schemas/PositionalArgument"
        - $ref: "#/components/schemas/NamedArgument"
    KeyValueInput:
      allOf:
        - $ref: "#/components/schemas/InputWithVariables"
        - type: object
          required:
            - name
          properties:
            name:
              description: Name of the header or environment variable.
              type: string
              example: SOME_VARIABLE
    StreamableHttpTransport:
      type: object
      properties:
        type:
          description: Transport type
          type: string
          example: streamable-http
          enum:
            - streamable-http
        url:
          description: "URL template for the streamable-http transport. Variables in
            {curly_braces} are resolved based on context: In Package context,
            they reference argument valueHints, argument names, or environment
            variable names from the parent Package. In Remote context, they
            reference variables from the transport's 'variables' object. After
            variable substitution, this should produce a valid URI."
          type: string
          example: https://api.example.com/mcp
          pattern: ^https?://[^\s]+$
        headers:
          description: HTTP headers to include
          type: array
          items:
            $ref: "#/components/schemas/KeyValueInput"
      required:
        - type
        - url
    SseTransport:
      type: object
      properties:
        type:
          description: Transport type
          type: string
          example: sse
          enum:
            - sse
        url:
          description: "Server-Sent Events endpoint URL template. Variables in
            {curly_braces} are resolved based on context: In Package context,
            they reference argument valueHints, argument names, or environment
            variable names from the parent Package. In Remote context, they
            reference variables from the transport's 'variables' object. After
            variable substitution, this should produce a valid URI."
          type: string
          example: https://mcp-fs.example.com/sse
          pattern: ^https?://[^\s]+$
        headers:
          description: HTTP headers to include
          type: array
          items:
            $ref: "#/components/schemas/KeyValueInput"
      required:
        - type
        - url
    Input:
      type: object
      properties:
        description:
          description: A description of the input, which clients can use to provide
            context to the user.
          type: string
        isRequired:
          type: boolean
          default: false
        format:
          description: >-
            Specifies the input format. Supported values include `filepath`,
            which should be interpreted as a file on the user's filesystem.


            When 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.
          type: string
          default: string
          enum:
            - string
            - number
            - boolean
            - filepath
        value:
          description: >
            The value for the input. If this is not set, the user may be
            prompted to provide a value. If a value is set, it should not be
            configurable by end users.


            Identifiers 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.
          type: string
        isSecret:
          description: Indicates whether the input is a secret value (e.g., password,
            token). If true, clients should handle the value securely.
          type: boolean
          default: false
        default:
          description: The default value for the input.  This should be a valid value for
            the input.  If you want to provide input examples or guidance, use
            the `placeholder` field instead.
          type: string
        placeholder:
          description: A placeholder for the input to be displaying during configuration.
            This is used to provide examples or guidance about the expected form
            or content of the input.
          type: string
        choices:
          description: A list of possible values for the input. If provided, the user must
            select one of these values.
          type: array
          items:
            type: string
          example: []
    StdioTransport:
      type: object
      properties:
        type:
          description: Transport type
          type: string
          example: stdio
          enum:
            - stdio
      required:
        - type
    PositionalArgument:
      description: A positional input is a value inserted verbatim into the command line.
      allOf:
        - $ref: "#/components/schemas/InputWithVariables"
        - type: object
          required:
            - type
          properties:
            type:
              type: string
              example: positional
              enum:
                - positional
            valueHint:
              description: An identifier for the positional argument. It is not part of the
                command line. It may be used by client configuration as a label
                identifying the argument. It is also used to identify the value
                in transport URL variable substitution.
              type: string
              example: file_path
            isRepeated:
              description: Whether the argument can be repeated multiple times in the command
                line.
              type: boolean
              default: false
        - anyOf:
            - type: object
              required:
                - valueHint
            - type: object
              required:
                - value
    NamedArgument:
      description: A command-line `--flag={value}`.
      allOf:
        - $ref: "#/components/schemas/InputWithVariables"
        - type: object
          required:
            - type
            - name
          properties:
            type:
              type: string
              example: named
              enum:
                - named
            name:
              description: The flag name, including any leading dashes.
              type: string
              example: --port
            isRepeated:
              description: Whether the argument can be repeated multiple times.
              type: boolean
              default: false
    InputWithVariables:
      allOf:
        - $ref: "#/components/schemas/Input"
        - type: object
          properties:
            variables:
              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.
              type: object
              additionalProperties:
                $ref: "#/components/schemas/Input"
    ServerDetail:
      description: Schema for a static representation of an MCP server. Used in
        various contexts related to discovery, installation, and configuration.
      type: object
      properties:
        name:
          description: Server name in reverse-DNS format. Must contain exactly one forward
            slash separating namespace from server name.
          type: string
          example: io.github.user/weather
          maxLength: 200
          minLength: 3
          pattern: ^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$
        description:
          description: Clear human-readable explanation of server functionality. Should
            focus on capabilities, not implementation details.
          type: string
          example: MCP server providing weather data and forecasts via OpenWeatherMap API
          maxLength: 100
          minLength: 1
        title:
          description: Optional human-readable title or display name for the MCP server.
            MCP subregistries or clients MAY choose to use this for display
            purposes.
          type: string
          example: Weather API
          maxLength: 100
          minLength: 1
        repository:
          allOf:
            - $ref: "#/components/schemas/Repository"
            - description: Optional repository metadata for the MCP server source code.
                Recommended for transparency and security inspection.
        version:
          description: Version string for this server. SHOULD follow semantic versioning
            (e.g., '1.0.2', '2.1.0-alpha'). Equivalent of Implementation.version
            in MCP specification. Non-semantic versions are allowed but may not
            sort predictably. Version ranges are rejected (e.g., '^1.2.3',
            '~1.2.3', '>=1.2.3', '1.x', '1.*').
          type: string
          example: 1.0.2
          maxLength: 255
        websiteUrl:
          description: Optional URL to the server's homepage, documentation, or project
            website. This provides a central link for users to learn more about
            the server. Particularly useful when the server has custom
            installation instructions or setup requirements.
          type: string
          format: uri
          example: https://modelcontextprotocol.io/examples
        icons:
          description: "Optional set of sized icons that the client can display in a user
            interface. Clients that support rendering icons MUST support at
            least the following MIME types: image/png and image/jpeg (safe,
            universal compatibility). Clients SHOULD also support: image/svg+xml
            (scalable but requires security precautions) and image/webp (modern,
            efficient format)."
          type: array
          items:
            $ref: "#/components/schemas/Icon"
        $schema:
          description: JSON Schema URI for this server.json format
          type: string
          format: uri
          example: https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json
        packages:
          type: array
          items:
            $ref: "#/components/schemas/Package"
        remotes:
          type: array
          items:
            $ref: "#/components/schemas/RemoteTransport"
        _meta:
          description: Extension metadata using reverse DNS namespacing for
            vendor-specific data
          type: object
          properties:
            io.modelcontextprotocol.registry/publisher-provided:
              description: Publisher-provided metadata for downstream registries
              type: object
              example:
                tool: publisher-cli
                version: 1.2.3
                buildInfo:
                  commit: abc123def456
                  timestamp: 2023-12-01T10:30:00Z
                  pipelineId: build-789
              additionalProperties: true
      required:
        - name
        - description
        - version
```
