Jupyter MCP Spaces
Lists and opens the notebooks of a Datalayer space.
Datalayer keeps notebooks in spaces, addressed by uid. There is no filesystem and no kernels API, so the tools that assume a Jupyter server have nothing to answer:
| Tool | On a Jupyter server | On Datalayer |
|---|---|---|
list_files |
lists the directory | nothing to list |
list_kernels |
lists kernels | runtimes, provisioned on demand |
list_notebooks |
notebooks bound this session | — |
This extension replaces list_notebooks with one that answers the question
people actually ask, adds list_spaces and find_notebook, and hides the
tools that cannot work — so an agent is never offered a tool that always
fails.
Install
pip install jupyter-mcp-spaces
It registers itself on the jupyter_mcp_server.extensions entry point and
activates only when the server runs with --document-provider datalayer.
Pointed at a Jupyter server it does nothing, and the ordinary tools stay.
jupyter-mcp-server start --transport streamable-http \
--document-provider datalayer \
--document-url https://prod1.datalayer.run
Tools
| Tool | What it answers |
|---|---|
list_spaces |
The spaces you can reach |
list_notebooks |
The notebooks in them, with uid and space |
find_notebook |
Which notebook a name means — or the candidates, when it is ambiguous |
find_notebook never picks between candidates. Guessing which notebook
somebody meant is how an agent edits the wrong one.
Credentials
Every call carries the token of the request being served, from
jupyter_mcp_server.identity. A server acting for several people over its
life must use the credential each request arrived with, not one configured at
startup — see the identity
documentation.
1 maintainer
Metadata
1 maintainer
Release files for jupyter-mcp-spaces 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| jupyter_mcp_spaces-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for jupyter_mcp_spaces-0.1.3-py3-none-any.whl |
Release files / jupyter_mcp_spaces-0.1.3-py3-none-any.whl
| Download URL | jupyter_mcp_spaces-0.1.3-py3-none-any.whl |
|---|---|
| Size | 9.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aaa6a111fb608b08c0aaf571b9cffb3c573a7e185ec007b4d524b459c761a9e6
|
|
BLAKE2b-256 checksum How to use checksums |
fc3e19aac9236d40583bfcb43bb9d1f36947527972c02e665bc83c631e4991d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.11
|
Security for jupyter-mcp-spaces 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
