PromptQL MCP Server

Status: Unstable and only for PromptQL v1. Alpha release coming soon for PromptQL v2.

Local serverstdio

What is the PromptQL MCP Server?

PromptQL MCP Server is an MCP project maintained in the hasura/promptql-mcp repository. The maintainer describes its purpose as “Status: Unstable and only for PromptQL v1. Alpha release coming soon for PromptQL v2”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /full/path/to/python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
start_thread	Start a new conversation thread with an initial message and wait for completion (returns thread_id, interaction_id, and response)
start_thread_without_polling	Start a new conversation thread without waiting for completion (returns thread_id and interaction_id immediately)
continue_thread	Continue an existing thread with a new message (maintains conversation context)
get_thread_status	Check the status of a thread (processing/complete) using GET /threads/v2/{thread_id}
cancel_thread	Cancel the processing of the latest interaction in a thread
setup_config	Configure PromptQL API key, playground URL, DDN Auth Token, and authentication mode (public/private)
check_config	Verify the current configuration status including authentication mode

How to install the PromptQL MCP Server

{
  "mcpServers": {
    "promptql": {
      "command": "/full/path/to/python",
      "args": [
        "-m",
        "promptql_mcp_server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.