Execution

insert_execute_code_cell

Insert a cell at specified index from the currently activated notebook and then execute it with timeout and return it's outputs

Insert a cell at specified index from the currently activated notebook and then execute it with timeout and return it's outputs It is a shortcut tool for insert_cell and execute_cell tools, recommended to use if you want to insert a cell and execute it at the same time

destructive: yes · idempotent: no · open-world: yes

Parameters

ParameterTypeRequiredDefaultDescription
cell_indexintegeryes—Index of the cell to insert and execute (0-based)
cell_sourcestringyes—Code source for the cell
timeoutintegerno0Maximum seconds to wait for execution (0 = use config default)
streambooleannotrueEnable streaming progress (including time indicator) updates for long-running cells
progress_intervalintegerno5Seconds between progress updates (MCP keepalive + optional stream log)

Output

{
  "properties": {
    "kind": {
      "description": "What this result is — 'cell.read', 'notebooks.list' and so on. Lets a client tell one answer from another without matching prose.",
      "title": "Kind",
      "type": "string"
    },
    "result": {
      "default": null,
      "description": "The answer itself: a message, the rows of a listing, or the outputs of an execution in order.",
      "title": "Result"
    },
    "outputs": {
      "description": "The outputs in order: text as text, an image as its own object.",
      "items": {},
      "title": "Outputs",
      "type": "array"
    },
    "count": {
      "default": 0,
      "description": "How many outputs.",
      "title": "Count",
      "type": "integer"
    },
    "images": {
      "default": 0,
      "description": "How many of them are images.",
      "title": "Images",
      "type": "integer"
    }
  },
  "required": [
    "kind"
  ],
  "type": "object",
  "additionalProperties": true,
  "description": "Cell or execution outputs, in order.",
  "title": "OutputsAnswer"
}

Call it

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "insert_execute_code_cell",
    "arguments": {
      "cell_index": 0,
      "cell_source": "<cell_source>",
      "timeout": 0,
      "stream": true,
      "progress_interval": 5
    }
  }
}
result = await session.call_tool("insert_execute_code_cell", arguments={"cell_index": 0, "cell_source": "<cell_source>", "timeout": 0, "stream": True, "progress_interval": 5})

Source

Registered by the @mcp.tool decorator on insert_execute_code_cell in jupyter_mcp_server/server.py.

Built withSourcey