Skip to main content

BlazeSQL MCP Server Documentation

Updated yesterday

BlazeSQL MCP Server

BlazeSQL provides an MCP (Model Context Protocol) server that lets you query your databases using natural language from any MCP-compatible client — including Claude, ChatGPT, Cursor, Windsurf, and more.

Prerequisites

  • A BlazeSQL account with at least one connected database

  • An active Blaze Team Advanced subscription

Server URLs

  • https://mcp.blazesql.com — For Claude, Cursor, Windsurf, and most other MCP clients

Endpoint supports:

  • Streamable HTTP transport (modern clients)

  • OAuth 2.0 with Dynamic Client Registration (DCR)

The endpoint also supports SSE + messages transport for legacy clients.

Supported Clients

Claude (Claude.ai, Claude Desktop, & Claude Code)

Works with Claude.ai, Claude Desktop, and Claude Code. Add the MCP server URL (https://mcp.blazesql.com) in your Claude MCP settings. You'll be prompted to authenticate via OAuth. See this dedicated guide on connecting to Claude.ai

ChatGPT

BlazeSQL is available as a ChatGPT connector. When connected, you can ask questions about your data directly in ChatGPT conversations. Results are displayed in an interactive widget with tables, SQL preview, and AI-generated insights.

To connect: Open ChatGPT → Settings → Connected Apps → Search for "BlazeSQL" → Connect → Sign in with your BlazeSQL account.

ChatGPT uses the dedicated endpoint

Cursor, Windsurf & Other IDE Clients

Simply use the URL https://mcp.blazesql.com


​

Available Tools

Once connected, the following tools are available to your AI assistant:

blazesql_query

Execute a natural language query against your connected database. Pass your question in plain English — BlazeSQL will generate the appropriate SQL, execute it, and return the results with an AI-generated analysis.

Example: "What were our top 10 customers by revenue last quarter?"

check_query_status

For long-running queries, this tool lets the AI client poll for results. It's used automatically when a query takes longer than the client's timeout threshold.


​

Authentication

The MCP server uses OAuth 2.0 with Dynamic Client Registration (DCR). This means:

  • No API keys or manual configuration needed

  • Your MCP client registers automatically on first connection

  • You sign in with your BlazeSQL email and password (or Google SSO)

  • Tokens are scoped to your account and connected databases

OAuth Endpoints (general server):

  • Registration: https://mcp.blazesql.com/register

  • Authorization: https://mcp.blazesql.com/authorize

  • Token: https://mcp.blazesql.com/token
    ​

Security & Privacy

  • We strongly recommend connecting with read-only database credentials. BlazeSQL is designed for analytical queries, but the level of access depends on the credentials you provide. Read-only credentials ensure no data can be modified through MCP queries.

  • Connections are encrypted via TLS

  • Your database credentials are never shared with MCP clients

  • Query results pass through BlazeSQL's servers but are not stored beyond the session

  • See our Privacy Policy for full details on data handling


​

Troubleshooting

Authentication fails or loops

Try disconnecting and reconnecting the MCP server in your client.

Query returns an error

Make sure your database connection is active in BlazeSQL. Go to https://blazesql.com/app and check that your database shows as connected.

Subscription requirement

MCP access requires a Blaze Team Advanced subscription. Upgrade from your BlazeSQL dashboard under Settings → Billing.

Need help?

Reach out via the chat widget or email us at [email protected].

Did this answer your question?