Julia MCP reference

toolMCPlatest

`create_session`

create_session( command: Array<string>, name: string, )

tool[source]¶

Start an argv command in a new application-owned session. Requires allow_create; the session is removed when the application closes. Completion means creation, not command exit.

MCP request method: tools/call Send create_session as the tool name, with the arguments below.
Tool selection: Opt in with --tool create_session.

Arguments#

additionalProperties: false

command: Array<string> Required #

Executable and argv; no shell expansion

minItems
1
maxItems
32
- Items: string #
  
  Valid UTF-8; at most 1024 bytes
  
  maxLength
  1024
name: string Required #

Valid UTF-8; at most 64 bytes

maxLength
64
pattern
"^[A-Za-z0-9_-]+$"

Result#

Returns object | object

Matches one or more variants.

Variant 1: object #

additionalProperties
false
- completed: boolean Required #
- generation: string Required #
- ownership: "application" Required #
- panes: Array<object> Required #
  
  maxItems
  256
  - Items: object #
    
    additionalProperties
    false
    - generation: string Required #
      
      Opaque generation from list_panes
      
      maxLength
      128
    - paneId: string Required #
      
      Valid UTF-8; at most 64 bytes
      
      maxLength
      64
      pattern
      "^%(0|[1-9][0-9]*)$"
- sessionId: string Required #
Variant 2: object #
- error: object Required #
  
  additionalProperties
  false
  - code: string Required #
  - effects: "none" | "possible" Required #
  - message: string Required #
  - retryable: boolean Required #

Annotations#

destructiveHint: false
idempotentHint: false
openWorldHint: true
readOnlyHint: false

Protocol data#

Use the complete advertised contract for validation and client integration.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "command": {
      "description": "Executable and argv; no shell expansion",
      "items": {
        "description": "Valid UTF-8; at most 1024 bytes",
        "maxLength": 1024,
        "type": "string"
      },
      "maxItems": 32,
      "minItems": 1,
      "type": "array"
    },
    "name": {
      "description": "Valid UTF-8; at most 64 bytes",
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9_-]+$",
      "type": "string"
    }
  },
  "required": [
    "name",
    "command"
  ],
  "type": "object"
}

Output schema

{
  "anyOf": [
    {
      "additionalProperties": false,
      "properties": {
        "completed": {
          "type": "boolean"
        },
        "generation": {
          "type": "string"
        },
        "ownership": {
          "const": "application"
        },
        "panes": {
          "items": {
            "additionalProperties": false,
            "properties": {
              "generation": {
                "description": "Opaque generation from list_panes",
                "maxLength": 128,
                "type": "string"
              },
              "paneId": {
                "description": "Valid UTF-8; at most 64 bytes",
                "maxLength": 64,
                "pattern": "^%(0|[1-9][0-9]*)$",
                "type": "string"
              }
            },
            "required": [
              "paneId",
              "generation"
            ],
            "type": "object"
          },
          "maxItems": 256,
          "type": "array"
        },
        "sessionId": {
          "type": "string"
        }
      },
      "required": [
        "completed",
        "panes",
        "sessionId",
        "generation",
        "ownership"
      ],
      "type": "object"
    },
    {
      "properties": {
        "error": {
          "additionalProperties": false,
          "properties": {
            "code": {
              "type": "string"
            },
            "effects": {
              "enum": [
                "none",
                "possible"
              ]
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "effects",
            "retryable"
          ],
          "type": "object"
        }
      },
      "required": [
        "error"
      ],
      "type": "object"
    }
  ],
  "type": "object"
}

Scripting & web

Compiled & native

JVM

.NET

tmux

`create_session`

Arguments#

Result#

Annotations#

Protocol data#