Advertise
MCP.so
Sign In

PromptQL MCP Server

@hasura

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

hasura

About PromptQL MCP Server

Model Context Protocol (MCP) server for Hasura PromptQL

PromptQL MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "promptql-mcp": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

PromptQL MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is PromptQL MCP Server?

It bridges Hasura’s PromptQL data agent with AI assistants via the Model Context Protocol (MCP), enabling natural language queries against enterprise data. The server is currently unstable and only for PromptQL v1; an alpha release for v2 is coming soon.

How to use PromptQL MCP Server?

Install from source by cloning the repository, creating a Python 3.10+ virtual environment, and running pip install -e .. Configure credentials with python -m promptql_mcp_server setup (using flags for API key, playground URL, auth token, and auth mode) or via environment variables (PROMPTQL_API_KEY, PROMPTQL_PLAYGROUND_URL, PROMPTQL_AUTH_TOKEN, PROMPTQL_AUTH_MODE). For Claude Desktop, add the server to the MCP configuration JSON, pointing to the Python executable.

Key features of PromptQL MCP Server

  • Natural language data queries in plain English
  • Table artifact support for formatted results
  • Secure configuration for API credentials
  • Dual authentication modes (public and private DDN)
  • Data analysis and visualization insights
  • Simple integration with MCP-compatible clients

Use cases of PromptQL MCP Server

  • Ask “What were our total sales last quarter?”
  • Request “Who are our top five customers by revenue?”
  • Analyze “Show me the trend of new user signups over the past 6 months”
  • Query “Which products have the highest profit margin?”
  • Perform multi-turn conversational data analysis with context retention

Frequently asked questions

1

What authentication modes does PromptQL MCP Server support?

It supports two modes: public (default, uses `Auth-Token` header for public DDN endpoints) and private (uses `x-hasura-ddn-token` header for private/internal DDN deployments).

2

What are the prerequisites for using PromptQL MCP Server?

Python 3.10 or higher, a Hasura PromptQL project with API key, playground URL, and DDN Auth Token, and an MCP-compatible client such as Claude Desktop.

3

How do I configure credentials for PromptQL MCP Server?

You can run `python -m promptql_mcp_server setup` with `--api-key`, `--playground-url`, `--auth-token`, and `--auth-mode` flags, or set the environment variables `PROMPTQL_API_KEY`, `PROMPTQL_PLAYGROUND_URL`, `PROMPTQL_AUTH_TOKEN`, and `PROMPTQL_AUTH_MODE`.

4

What tools does PromptQL MCP Server expose?

It exposes `start_thread`, `start_thread_without_polling`, `continue_thread`, `get_thread_status`, `cancel_thread`, `setup_config`, and `check_config` as MCP tools, plus a `data_analysis` prompt.

5

How do I switch between public and private authentication modes?

Reconfigure the server using the `--auth-mode` flag (`public` or `private`) in the setup command or update the `PROMPTQL_AUTH_MODE` environment variable accordingly.

Comments

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise