deepnote/agent-plugins/deepnote-static-sites

Deepnote Static Sites

Tool arguments and the capability boundary are defined in deepnote-mcp.

Publishing Workflow

1. Author and validate the HTML, CSS, and JavaScript in the local agent workspace.
2. If a local shell and the Deepnote CLI are available, prefer deepnote publish ./dist --project-id <uuid>, especially for local builds and larger sites.
3. If deployment must happen through hosted MCP, use publish_static_site. Send the final file contents in one call.
4. Use the canonical URL returned by the publish operation or the project's staticFiles.url from get_project. Never construct a static-site hostname.
5. Read the current sharing and viewer API state with get_project. To change access without changing files, use update_project with staticFiles.sharingEnabled and/or staticFiles.apiAccessEnabled. Disabling sharing also disables viewer API access; re-enabling sharing serves the retained files again.
6. Do not execute a notebook to write published files, and do not look for generic file-write tools. publish_static_site writes only beneath the static-site root, while copy_file only copies an existing file between projects; neither uploads arbitrary project files.

Safety

Publishing makes the files available through the project's shared static site to anyone who can view the project. Never include API keys, personal tokens, .env contents, or other secrets. Viewer API access is separately opt-in and should be enabled only for browser apps that need the viewer-scoped Deepnote run API.

Reporting

Report the canonical site URL, the number of files published, the sharing state, and the viewer API state.