{"report":{"v":1,"package":"jupyterlab-collab-mcp","version":"0.15.0","ranAt":"2026-11-16T11:49:39.375Z","install":{"ok":true,"integrity":"sha512-5/P9agGy0Y8c3KIrz1vcM7iURz2ywUkr+h5xXpeqhnjjrIufmdHfhORM14KIrJhm6aZVD6Ky5105bpbuT3te1g==","deps":133,"scripts":["leveldown"],"bins":["jupyter-mcp"],"license":"BSD-3-Clause","engines":"node >=18.0.0","repository":"git+https://github.com/ianhi/jupyterlab-collab-mcp.git","bin":"jupyter-mcp"},"start":{"ok":true,"ms":167,"serverName":"jupyterlab-collab-mcp","serverVersion":"0.15.0","protocol":"2025-06-18","stderr":"JupyterLab MCP server started. Use connect_jupyter tool with your JupyterLab URL to begin.\n"},"tools":[{"name":"connect_jupyter","description":"Connect to JupyterLab for real-time sync and kernel execution. Without connecting, tools still work by reading .ipynb files directly.","params":["url"]},{"name":"list_files","description":"List files and directories. Use to discover notebooks.","params":["path"]},{"name":"list_notebooks","description":"List notebooks with running kernels. Use list_files for all .ipynb files regardless of kernel state.","params":[]},{"name":"list_kernels","description":"List available kernel types (e.g., python3, ir) and running instances.","params":[]},{"name":"troubleshoot","description":"Diagnose why notebook edits may not be syncing or persisting. Reports connection/RTC health and, for a given notebook, sync state, browser peers, a forced-save result, and a disk-vs-room round-trip check that detects split-brain (wrong/second server). Use when edits don't show up in the browser or on disk.","params":["path"]},{"name":"save_notebook","description":"Force a verified save of the notebook's live collaboration room to disk and report whether it persisted (success/skipped/failed). Use this to guarantee edits reach disk — NEVER edit the .ipynb file directly to 'save' it, as a direct file write is reverted by jupyter-collaboration and loses in-room edits.","params":["path"]},{"name":"open_notebook","description":"Open a notebook and start a kernel. Safe to call if already open. Required before executing cells.","params":["path","kernel_name"]},{"name":"create_notebook","description":"Create a new notebook. Optionally open it with a kernel.","params":["path","kernel_name","open","cells"]},{"name":"get_notebook_content","description":"Read cells from a notebook. Returns source only (no outputs) by default. Set include_outputs=true to see results.","params":["path","cell_type","include_outputs","output_format","start_index","end_index","indices","cell_ids","max_output_chars"]},{"name":"get_notebook_outline","description":"Condensed notebook structure: markdown headers by level + code cell previews. Use to find cell indices.","params":["path"]},{"name":"search_notebook","description":"Grep through notebook cells (regex). Returns matching cells with context.","params":["path","pattern","search_in","case_sensitive","max_results","context_lines"]},{"name":"replace_in_notebook","description":"Search and replace across cells. Returns replacement count per cell.","params":["path","search","replace","cell_type","case_sensitive","regex","indices","dry_run"]},{"name":"rename_symbol","description":"Scope-aware Python rename across all cells. Won't rename in strings/comments.","params":["path","cell_index","line","character","new_name"]},{"name":"get_diagnostics","description":"Static code diagnostics (errors, warnings) without executing. Uses LSP or Python syntax checking.","params":["path","cell_index","cell_id"]},{"name":"get_hover_info","description":"Documentation/type info for code at a position. Uses LSP or kernel introspection.","params":["path","cell_index","line","character"]},{"name":"get_user_focus","description":"Which cell the user is editing (cursor position via awareness protocol). Returns null if no active user.","params":["path"]},{"name":"insert_cell","description":"Insert a cell. Set execute=true to run it immediately and return its output — a single-call, durable alternative to execute_code (code+output are saved in the notebook and visible to the human). Supports handoff_after_ms for long runs.","params":["path","index","cell_id","source","cell_type","execute","timeout","max_images","include_images","handoff_after_ms","client_name"]},{"name":"update_cell","description":"Update a cell's source. Set execute=true to run it after updating.","params":["path","index","cell_id","source","cell_type","force","execute","timeout","max_images","include_images","show_diff","handoff_after_ms","client_name"]},{"name":"batch_update_cells","description":"Update multiple cells atomically. More efficient than repeated update_cell.","params":["path","updates","client_name"]},{"name":"batch_insert_cells","description":"Insert multiple cells at once, applied in order. Each `index` is the literal position in the notebook as it stands at that step (after earlier inserts in this batch). For a contiguous block, pass increasing indices (e.g. 20, 21, 22) or anchor with `cell_id`. Omit index to append.","params":["path","inserts","client_name"]},{"name":"delete_cell","description":"Delete cells. Single: index or cell_id. Batch: indices[], cell_ids[], or start_index+end_index.","params":["path","index","cell_id","indices","cell_ids","start_index","end_index","force","client_name"]},{"name":"change_cell_type","description":"Convert cell type (code <-> markdown) in place.","params":["path","index","cell_id","new_type","force"]},{"name":"copy_cells","description":"Copy or move cells between notebooks. Set delete_source=true to move.","params":["source_path","dest_path","start_index","end_index","cell_ids","dest_index","dest_cell_id","delete_source","client_name"]},{"name":"execute_cell","description":"Execute notebook cells. Single cell: use index/cell_id. Range: add end_index. By IDs: use cell_ids[]. Skips non-code cells in range mode.","params":["path","index","cell_id","end_index","cell_ids","timeout","max_images","include_images","handoff_after_ms"]},{"name":"execute_code","description":"Run throwaway code in the kernel without modifying the notebook — for quick probes whose output you don't need to keep. Output is NOT saved and only briefly retained. For anything worth keeping or showing a human, prefer insert_cell(execute=true): same single call, but code+output are saved in the notebook.","params":["path","code","timeout","max_images","include_images","handoff_after_ms"]},{"name":"get_cell_run_output","description":"Fetch output for a run started by execute_cell/execute_code (typically one that handed off via handoff_after_ms). Works for runs still executing AND completed runs — also the right tool to call when a <channel source=\"jupyter\"> notification fires.","params":["run_id","kernel_id","max_images","include_images"]},{"name":"list_runs","description":"List recent kernel runs (from execute_cell/execute_code) and their states (queued/running/handed_off/completed/failed), most-recent-first. Use this to discover a run_id or check whether a handed-off run is still executing vs. finished vs. evicted, instead of blindly holding an id that may be gone.","params":["kernel_id","limit"]},{"name":"clear_outputs","description":"Clear execution outputs. Omit index to clear all cells.","params":["path","index","cell_id","force"]},{"name":"get_cell_outputs","description":"Read cell outputs without source code. Supports single cell, range, or non-contiguous selection.","params":["path","index","end_index","indices","cell_ids","max_images","include_images"]},{"name":"filter_output","description":"Filter cached execution output with grep/head/tail. Use after execute_cell or execute_code — avoids re-executing.","params":["path","execution_id","grep","tail","head","max_lines","max_images","include_images"]},{"name":"cell_metadata","description":"Get or set cell metadata. Omit 'metadata' to GET, provide to SET (merges, null deletes keys).","params":["path","index","end_index","indices","cell_ids","metadata"]},{"name":"cell_tags","description":"Add, remove, or find tags on cells. Common: 'hide-input', 'hide-output', 'parameters'.","params":["path","action","index","end_index","indices","cell_ids","tags","match_all","include_preview"]},{"name":"notebook_metadata","description":"Get or set notebook-level metadata. Omit 'metadata' to GET, provide to SET.","params":["path","metadata"]},{"name":"kernel","description":"Kernel control: status, interrupt, or restart.","params":["path","action"]},{"name":"kernel_variables","description":"List or inspect kernel variables. Without 'names': lists all. With 'names': deep inspect (columns, dtypes, shapes).","params":["path","names","detail","filter","include_private","max_variables","max_items","max_name_length"]},{"name":"rename_notebook","description":"Rename a notebook file.","params":["path","new_path"]},{"name":"diff_notebooks","description":"Compare two notebooks cell by cell. Returns unified diff.","params":["path1","path2","include_outputs","summary_only","max_diffs"]},{"name":"get_cell_history","description":"Change history for a cell: who, when, old/new content. Session-scoped.","params":["path","cell_id","limit"]},{"name":"get_notebook_changes","description":"Changes since a version number (polling pattern). Use since_version=0 for all.","params":["path","since_version","limit"]},{"name":"recover_cell","description":"Re-insert a deleted cell from change history. Session-scoped.","params":["path","cell_id","index","client_name"]},{"name":"snapshot","description":"Notebook snapshots: save, restore, list, or diff against current.","params":["path","action","name","description"]},{"name":"cell_locks","description":"Advisory cell locks: acquire, release, or list.","params":["path","action","cell_ids","owner","ttl_minutes","force"]},{"name":"report_issue","description":"Report a tool bug, hang, or suggestion about this MCP server. Logs locally and returns a structured GitHub-issue draft (title + sectioned body) for ianhi/jupyterlab-collab-mcp. This project accepts fully agent-drafted issues.","params":["category","summary","tool_name","path","details"]},{"name":"notebook_guide","description":"Best practices for working with notebooks via this server. Call this FIRST when starting notebook work (or when unsure which tool to use) — returns guidance on reading, editing, executing, collaborating, and troubleshooting. Optionally pass a topic to get just one section.","params":["topic"]}],"toolsHash":"a4868ceaa4e07207d0011795035fa0ab2b2e688f7beac65d82707d08590045fa","wrote":[],"callsAt":"2026-11-16T11:49:45.992Z","calls":[{"tool":"list_files","ok":true,"ms":8,"bytes":327},{"tool":"list_notebooks","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: Error: Not connected to JupyterLab. Use connect_jupyter tool first with your JupyterLab URL."},{"tool":"list_kernels","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Error: Not connected to JupyterLab. Use connect_jupyter tool first with your JupyterLab URL."},{"tool":"list_runs","ok":true,"ms":1,"bytes":119},{"tool":"notebook_guide","ok":true,"ms":0,"bytes":7680}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"orders","tool":"save_notebook","quote":"s/skipped/failed). Use this to guarantee edits reach disk — NEVER edit the .ipynb file directly to 'save' it, as a direct file write is reverted by jupyter-collabora"}],"tools":44,"wrote":0,"callsTried":5,"callsAnswered":3,"callContacts":[]},"history":[{"package":"jupyterlab-collab-mcp","version":"0.15.0","ranAt":"2026-11-16T11:49:39.375Z","outcome":"started","tools":44,"contacts":0,"flags":1,"serious":0,"toolsHash":"a4868ceaa4e07207d0011795035fa0ab2b2e688f7beac65d82707d08590045fa"}],"page":"https://bragproof.smaverk.com/r/jupyterlab-collab-mcp"}