{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ttbhr9tsuztj","handle":"jupyter-interpreter-mcp","url":"https://wellknown.network/agents/jupyter-interpreter-mcp","links":{"self":"https://wellknown.network/agents/jupyter-interpreter-mcp/record.json","html":"https://wellknown.network/agents/jupyter-interpreter-mcp","markdown":"https://wellknown.network/agents/jupyter-interpreter-mcp/record.md","api":"https://wellknown.network/api/v1/agents/jupyter-interpreter-mcp","status":"https://wellknown.network/api/v1/agents/jupyter-interpreter-mcp/status","claim":"https://wellknown.network/agents/jupyter-interpreter-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/jupyter-interpreter-mcp/claim.json","badge":"https://wellknown.network/agents/jupyter-interpreter-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/jupyter-interpreter-mcp/history","tools":"https://wellknown.network/api/v1/agents/jupyter-interpreter-mcp/tools"},"ard":{"identifier":"urn:air::server:jupyter-interpreter-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"jupyter-interpreter-mcp","summary":"A Jupyter-based MCP server for code interpretation","description":"# Jupyter Interpreter MCP\nA remote Jupyter-based MCP (Model Context Protocol) server for code interpretation. This server connects to a remote Jupyter server (e.g. running in a Docker container or cloud instance) and provides a persistent, sandboxed code execution environment similar to Jupyter notebooks. Supports both Python and bash command execution.\n\n## Architecture\n```\nMCP Server → RemoteJupyterClient → Jupyter REST API → Remote Kernel\n                                          ↓\n                              WebSocket Connection\n                                          ↓\n                           Jupyter server Filesystem\n```\nAll code executes within the remote Jupyter server. Session history files are stored in the server's filesystem, not on the host. You can execute both Python code and bash commands (e.g., ls, pwd, cat file.txt). Requirements\n\n## Requirements\n\n- Python 3.10 or higher\n- uv package manager\n- Network access to a Jupyter server\n\n## Quick Start\n\n### 1. (Optional) Start Jupyter Container\n\nThis is only necessary if you don't use any other remote instance of Jupyter.\nRun a Jupyter container with the required port mappings, e.g.:\n\n```bash\ndocker run -d \\\n  --name jupyter-notebook \\\n  -p 8889:8888 \\\n  jupyter/minimal-notebook:latest\n```\n\n### 2. Get Authentication Token\n\nCreate a new token for accessing the Jupyter server or use an existing token.\n\n### 3. Run the MCP server\n\n#### Using uvx\n\nStart the server using uvx:\n\n```bash\nuvx jupyter-interpreter-mcp --jupyter-base-url http://localhost:8889 --jupyter-token abc123def456... --sessions-dir /home/jovyan/sessions --session-ttl 3600\n```\n\nor to add it to e.g. Claude Code:\n\n```json\n{\n  \"mcpServers\": {\n    \"jupyter-interpreter-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"jupyter-interpreter-mcp\",\n        \"--jupyter-base-url\",\n        \"http://localhost:8889\",\n        \"--jupyter-token\",\n        \"abc123def456...\",\n        \"--sessions-dir\",\n        \"/home/jovyan/sessions\",\n        \"--session-ttl…","publisher":{"name":"Leopold Seidler","url":null},"homepage":null,"repository":null,"version":"0.4.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:jupyter-interpreter-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.execution","name":"Code Execution","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"jupyter-interpreter-mcp","registry":"pypi","observedAt":"2026-10-28T08:27:57.909Z","publishedAt":"2026-03-23T10:21:09.030819Z","latestVersion":"0.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"jupyter-interpreter-mcp","url":"https://pypi.org/project/jupyter-interpreter-mcp/","firstSeenAt":"2026-09-09T22:22:49.526Z","fetchedAt":"2026-10-28T08:25:59.242Z","normalizedAt":"2026-10-28T08:25:59.242Z"}]},"firstSeenAt":"2026-09-09T22:22:49.526Z","updatedAt":"2026-10-28T08:27:57.909Z"}