## Tool: `create_session`

Opens a Jupyter kernel session on a runtime (`runtimes/{runtime_id}`) and returns its name (`runtimes/{runtime_id}/sessions/{session_id}`).

`execute_code` calls that target the session share its kernel state (variables, imports). Reuse a session you opened rather than opening another, and close it with `delete_session` when you're done, because each open session holds kernel memory. Opening a session with the ID of an open one returns that session.

The following code sample shows how to use `curl` to call the `create_session` MCP tool.

| Curl Request |
|---|
| ```bash curl --location 'https://colaboratory.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "create_session", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' ``` |

## Input Schema

Request message for `CreateSession`.

### CreateSessionRequest

| JSON representation |
|---|
| ``` { "parent": string, "sessionId": string, "session": { object (`Session`) } } ``` |

| Fields ||
|---|---|
| `parent` | `string` Required. The runtime on which to open the session. Format: `runtimes/{runtime}`. |
| `sessionId` | `string` Optional. The ID of the session, unique within the runtime. If unset, the server generates one. If a session with this ID is already open, it is returned, so retrying with the same ID is safe. 1-63 characters of lowercase letters, digits and hyphens, starting with a letter and ending with a letter or digit ([AIP-122](https://google.aip.dev/122#resource-id-segments)). |
| `session` | ``object (`Session`)`` Optional. Leave unset. The server ignores it, because a session has no fields to set. |

### Session

| JSON representation |
|---|
| ``` { "name": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The name of the session. Format: `runtimes/{runtime}/sessions/{session}`. |

## Output Schema

A Jupyter kernel session on a Colab runtime. Deleting the runtime closes its sessions.

### Session

| JSON representation |
|---|
| ``` { "name": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The name of the session. Format: `runtimes/{runtime}/sessions/{session}`. |

### Tool Annotations


[Tool annotations](https://modelcontextprotocol.io/specification/latest/schema#toolannotations) are sent to MCP clients to describe the basic risk of a given tool. Most clients treat these hints as untrusted, but they can be used to decide when a confirmation prompt might be sent to a user.


Along with the title string, the following boolean hints are defined as follows:

- `readOnlyHint`: If true, the tool doesn't modify its environment. Default: false.
- `destructiveHint`: If true, then the tool can perform destructive actions. If false, then the tool can only perform additive actions. Default: true.
- `idempotentHint`: If true, then calling the tool repeatedly with the same arguments will have no additional effect on its environment. Default: false.
- `openWorldHint`: If true, then the tool can interact with an 'open world' of external entities. If false, then the tool can only interact with internal entities. For example, a web search tool would be open world, while a memory tool would not be open world.

Destructive Hint: ❌ \| Idempotent Hint: ❌ \| Read Only Hint: ❌ \| Open World Hint: ❌