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 |
|---|
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 ( |
| Fields | |
|---|---|
parent |
Required. The runtime on which to open the session. Format: |
sessionId |
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). |
session |
Optional. Leave unset. The server ignores it, because a session has no fields to set. |
Session
| JSON representation |
|---|
{ "name": string } |
| Fields | |
|---|---|
name |
Identifier. The name of the session. Format: |
Output Schema
A Jupyter kernel session on a Colab runtime. Deleting the runtime closes its sessions.
Session
| JSON representation |
|---|
{ "name": string } |
| Fields | |
|---|---|
name |
Identifier. The name of the session. Format: |
Tool Annotations
Tool annotations 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: ❌