# mcp-server-questdb

Connects coding agents to a running QuestDB Web Console: notebook cells, SQL queries, and charts.

MCP server by QuestDB. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx add-mcp @questdb/mcp-server-questdb
```

Works with: Claude Code, Codex CLI, Cursor, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx add-mcp @questdb/mcp-server-questdb -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Where it runs

Your computer.

## What it needs

Environment variables:

- `CONSOLE_ORIGIN` (optional): QuestDB Web Console origin.
- `MCP_BRIDGE_PORT` (optional): Fixed WebSocket port for pairing. Auto-allocated when unset.
- `LOG_PATH` (optional): Log file location. Defaults to a timestamped file under /tmp/questdb-mcp-bridge.
- `LOG_LEVEL` (optional): Log verbosity. DEBUG adds heartbeats and full tool payloads.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Source

[Open the source](https://github.com/questdb/mcp-server-questdb). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

- Previous: [mcp-server-gravatar](https://syn4pse.dev/terminal/mcp-server-gravatar.md)
- Next: [milvus-marketplace](https://syn4pse.dev/terminal/zilliz-milvus-marketplace.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
