← Explore all mcp servers

ANALYTICS DATABASES / QuestDB

QuestDB MCP Server

Node server published in questdb/mcp-server-questdb that pairs a coding agent with a QuestDB Web Console session so the agent can drive notebook cells, queries, and charts in that browser session.

“An MCP server that connects coding agents (Claude Code, Codex, Cursor, OpenCode, Gemini CLI) to a running QuestDB Web Console. The agent gets tools to create notebook cells, run queries, and build charts. Every action executes in the browser against your already-established QuestDB session.”

01 / THE REASONING

Why this made the selection.

  • QuestDB publishes this package as @questdb/mcp-server-questdb in questdb/mcp-server-questdb. package.json at b80e8557c9b6a492fb17ba626ffb23721fe1e51e names author QuestDB, version 0.5.0, and license Apache-2.0.
  • The README's setup command and manual MCP config are printed in that file. src/pairingTools.ts registers get_pairing_credentials and wait_for_pairing, which the README describes as the step before notebook, chart, and SQL tools run.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md at b80e8557c9b6a492fb17ba626ffb23721fe1e51e: description, setup command, manual JSON, environment table, pairing, and licence line.
  • package.json at the same revision: name, version 0.5.0, author, Apache-2.0, engines node >=22, typescript in devDependencies.
  • LICENSE at the same revision: Apache License 2.0, appendix Copyright 2024 QuestDB Limited.
  • src/pairingTools.ts at the same revision: tool names get_pairing_credentials and wait_for_pairing.

Our findings

  • The manual config launches npx -y @questdb/mcp-server-questdb with no version. The quick-setup command is also unpinned.
  • Notebook tool names are not fixed in pairingTools.ts. The README describes notebook, query, and chart actions executing in the browser session after pairing. A log sample in the README shows the name run_query; that sample was not treated as the full tool list.
  • LICENSE appendix reads Copyright 2024 QuestDB Limited. package.json author is QuestDB.

Not established by this review

  • Not executed: it was not installed or run.
  • The setup wizard was not run and no Web Console was paired.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx @questdb/mcp-server-questdb setup

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Run the printed setup command. It is an interactive wizard that writes MCP config for the agents it detects.
  2. When the console requires a specific bridge, the README says to run npx @questdb/mcp-server-questdb@<version> setup instead of the unpinned command.
  3. Or paste the manual mcpServers block. For an environment without npm registry access, the README describes a release-attached .mjs bundle invoked as node /permanent/absolute/path/mcp-server-questdb-<version>.mjs setup.

Before you start

  • A running QuestDB Web Console.
  • Node and npx for the npm command, or Node >=22 for the standalone bundle described in the README.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "questdb": {
      "command": "npx",
      "args": [
        "-y",
        "@questdb/mcp-server-questdb"
      ]
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/questdb/mcp-server-questdb/blob/b80e8557c9b6a492fb17ba626ffb23721fe1e51e/README.md

    Supports: upstreamDescription, install, configExample, limitations, access, bestFor

  2. https://github.com/questdb/mcp-server-questdb/blob/b80e8557c9b6a492fb17ba626ffb23721fe1e51e/LICENSE

    Supports: license

  3. https://github.com/questdb/mcp-server-questdb/blob/b80e8557c9b6a492fb17ba626ffb23721fe1e51e/package.json

    Supports: language, compatibility, whySelected

  4. https://github.com/questdb/mcp-server-questdb/blob/b80e8557c9b6a492fb17ba626ffb23721fe1e51e/src/pairingTools.ts

    Supports: whySelected, review.findings

Evidence & Ask