# teardown_session

Source: https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/

> Destroy an exact generation-bound session created by this application. Borrowed sessions are refused.

toolMCPlatest

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

* **teardown_session**( [generation](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.input%2Fproperties%2Fgeneration): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"), [sessionId](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.input%2Fproperties%2FsessionId): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"), )

  tool[\[source\]](https://github.com/libtmux/libtmux-julia/blob/f3da513be1225d36d5854cd8db5972c01857578e/packages/LibTmuxMCP/src/tools.jl#L10)[¶](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session)

  Destroy an exact generation-bound session created by this application. Borrowed sessions are refused.

  * MCP request method

    `tools/call` Send `teardown_session` as the tool name, with the arguments below.

  * Tool selection

    Opt in with `--tool teardown_session`.

  ## Arguments[#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.parameters)

  * additionalProperties

    `false`

  - [**generation**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.input%2Fproperties%2Fgeneration): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.input%2Fproperties%2Fgeneration)

    Valid UTF-8; at most 128 bytes

    * maxLength

      `128`

  - [**sessionId**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.input%2Fproperties%2FsessionId): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.input%2Fproperties%2FsessionId)

    Valid UTF-8; at most 64 bytes

    * maxLength

      `64`

  ## Result[#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.result)

  Returns [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") | [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)")

  Matches one or more variants.

  * [**Variant 1**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0)

    * additionalProperties

      `false`

    - [**completed**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0%2Fproperties%2Fcompleted): [boolean](https://json-schema.org/understanding-json-schema/reference/boolean "boolean (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0%2Fproperties%2Fcompleted)

    - [**generation**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0%2Fproperties%2Fgeneration): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0%2Fproperties%2Fgeneration)

    - [**sessionId**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0%2Fproperties%2FsessionId): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F0%2Fproperties%2FsessionId)

  * [**Variant 2**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1)

    * [**error**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror)

      * additionalProperties

        `false`

      - [**code**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fcode): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fcode)

      - [**effects**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Feffects): "none" | "possible" Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Feffects)

      - [**message**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fmessage): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fmessage)

      - [**retryable**](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fretryable): [boolean](https://json-schema.org/understanding-json-schema/reference/boolean "boolean (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fretryable)

  ## Annotations[#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.annotations)

  * [`destructiveHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#destructiveHint)

    `true`

  * [`idempotentHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#idempotentHint)

    `false`

  * [`openWorldHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#openWorldHint)

    `true`

  * [`readOnlyHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#readOnlyHint)

    `false`

  ## Protocol data[#](https://libtmux.org/en/julia/latest/mcp/tools/teardown_session/#mcp.tool.teardown_session.schemas)

  Use the complete advertised contract for validation and client integration.

  Input schema

  ```json
  {
    "additionalProperties": false,
    "properties": {
      "generation": {
        "description": "Valid UTF-8; at most 128 bytes",
        "maxLength": 128,
        "type": "string"
      },
      "sessionId": {
        "description": "Valid UTF-8; at most 64 bytes",
        "maxLength": 64,
        "type": "string"
      }
    },
    "required": [
      "sessionId",
      "generation"
    ],
    "type": "object"
  }
  ```

  Output schema

  ```json
  {
    "anyOf": [
      {
        "additionalProperties": false,
        "properties": {
          "completed": {
            "type": "boolean"
          },
          "generation": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          }
        },
        "required": [
          "completed",
          "sessionId",
          "generation"
        ],
        "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"
  }
  ```