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

> 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

# PositionalArgument

A positional input is a value inserted verbatim into the command line.

## 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:
    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: []
    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
```
