list_systemsLABSCO SUMMARY
Batch PQ operations report per item instead of failing the lot.
pq_start, pq_stop, pq_restart and pq_delete each take a list and run in parallel under an operator-set concurrency cap, so one bad query does not sink a restart of twenty. dhcli describes itself at runtime through its own agent manifest, which is how an agent keeps up with a command surface the project says is still moving.
What it is
Deephaven's own server. One multiplexed process hosts every configured Community session and Enterprise system; a separate hosted documentation server answers questions about Deephaven itself.
What you get
- Configured sessions and systems listed, and an enterprise system's health read — list_systems, enterprise_systems_status
- Sessions created and deleted on either side, with credentials retrievable subject to policy — session_community_create, session_community_delete, session_community_credentials, session_enterprise_create, session_enterprise_delete
- Tables discovered and read on any session: names, schema and data with formatting options — sessions_list, session_details, session_tables_list, session_table_schema, session_table_data
- Python or Groovy executed on a session, and its installed packages listed — session_script_run, session_pip_list
- Persistent queries across their whole lifecycle, with start, stop, restart and delete taking a list of ids, running in parallel and reporting per item — pq_list, pq_details, pq_create, pq_modify, pq_start, pq_stop, pq_restart, pq_delete, pq_name_to_id
- The enterprise catalog browsed at table and namespace level, with schema and sample reads — catalog_tables_list, catalog_namespaces_list, catalog_table_schema, catalog_table_sample
- A hosted documentation server at https://deephaven-mcp-docs-prod.dhc-demo.deephaven.io/mcp answering natural-language Deephaven questions
Requirements
deephaven-mcp from PyPI provides three commands: dhcli, dh-mcp-systems-server and dh-mcp-docs-server. Configure with dhcli config init rather than editing JSON by hand. The documentation server is hosted and speaks streamable HTTP only, so stdio-only clients reach it through mcp-proxy. Configuration changes require a server restart.
Setup effort
Follow the published steps — uv tool install --python-preference managed "deephaven-mcp"
USE CASES
01
Exploring data that is still arriving
List the tables on a session, read the schema, then pull data with formatting — all against live dataframes rather than a snapshot.
02
Running analysis code where the data is
Execute Python or Groovy on the session itself, and check which packages that environment actually has before relying on an import.
03
Operating enterprise persistent queries
Create, modify and restart PQs by id across systems, with batch operations reporting success or failure for each one.
04
Finding a table in the enterprise catalog
Browse namespaces, then tables, then read one table's schema and sample its rows before writing anything against it.
27 tools
Listed in project docs. Your client may show a different list.
enterprise_systems_statussession_community_createsession_community_deletesession_community_credentialssession_enterprise_createsession_enterprise_deletepq_name_to_idpq_listpq_detailspq_createpq_modifypq_startpq_stoppq_restartpq_deletecatalog_tables_listcatalog_namespaces_listcatalog_table_schemacatalog_table_samplesessions_listsession_detailssession_tables_listsession_table_schemasession_table_datasession_script_runsession_pip_listBEFORE YOU INSTALL
What to know first
Tools you get
27 tools named in the project's documentation.
Requires
- dh-mcp-systems-server on PATH
- Python 3.12 or later
Where it runs
All 4 documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uv tool install --python-preference managed "deephaven-mcp"
dhcli config init
dhcli config validateMCP Clients
Claude Desktop, Windsurf
JSON
{
"mcpServers": {
"deephaven-systems": {
"command": "dh-mcp-systems-server",
"args": [
"--transport",
"stdio"
]
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"deephaven-systems": {
"type": "stdio",
"command": "dh-mcp-systems-server",
"args": [
"--transport",
"stdio"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"deephaven-systems": {
"command": "dh-mcp-systems-server",
"args": [
"--transport",
"stdio"
]
}
}
}
