---
title: "Package"
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/Package"
---

> 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

# Package

## 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:
    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
    StdioTransport:
      type: object
      properties:
        type:
          description: Transport type
          type: string
          example: stdio
          enum:
            - stdio
      required:
        - type
    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
    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"
    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: []
    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
```
