Skip to main content

BlazeSQL MCP Server Documentation

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 & Codex

BlazeSQL is available as a ChatGPT App/Plugin. When connected, you can ask questions about your data directly in ChatGPT conversations. Results are displayed in an interactive widget with tables and SQL preview. You can also create graphs (and add them to dashboards), explore existing dashboards and saved queries, and add context to the knowledge base.

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

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:

ist_schemas
Lists the schemas in your connected database, including descriptions and table counts.

list_tables
Lists the tables within one or more schemas, including table descriptions and column counts.

describe_tables
Returns detailed information about selected tables, including columns, data types, descriptions, and knowledge notes.

execute_sql
Executes a read-only SQL query against your connected database. It can also run an existing saved query.

list_saved_queries
Lists the saved queries and graphs you can access in BlazeSQL.

search_saved_queries
Searches accessible saved queries and graphs by name, description, or SQL.

read_saved_query
Returns the complete details of a selected saved query or graph, including its SQL and visualization settings.

list_dashboards
Lists the BlazeSQL dashboards you can access.

search_dashboards
Searches accessible dashboards, including their descriptions, text, and linked queries.

read_dashboard
Returns a dashboard’s details and ordered content, including text, queries, and graph tiles.

graph_sql_result
Creates an interactive graph from a completed SQL result or an existing saved query.

add_graph_to_dashboard
Saves a graph and adds it to a selected BlazeSQL dashboard.


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.

Need help?

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

Did this answer your question?