Text2sql MCP Server

Synechron's Text2SQL MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server. It provides MCP clients

Remote serverstreamable-httpPython

What is the Text2sql MCP MCP server?

Text2sql mcp mcp server lets Claude, Cursor and other MCP clients work with Text2sql MCP directly. Synechron's Text2SQL MCP Server is a Model Context Protocol (MCP) server. It provides MCP clients like Cursor, VSCode, and Claude Desktop, with natural language access to relational databases of various types – enabling users to ask questions of their.

What Text2sql MCP does

Synechron's Text2SQL MCP Server is a Model Context Protocol (MCP) server. It provides MCP clients like Cursor, VSCode, and Claude Desktop, with natural language access to relational databases of various types – enabling users to ask questions of their data using natural language capabilities.

Key capabilities

  • Natural Language to SQL: — Natural language questions are converted into optimized SQL queries using advanced
  • Multi-Database Support: — Compatibility with PostgreSQL, MySQL, SQLite and Microsoft Fabric databases
  • Retrieval Augmented Generation (RAG): — Enhanced query generation by combining schema metadata and sampled row
  • Table Indexing: — Enables embedding for database schemas and sample data, improving query relevance
  • Response Synthesis: — Generates natural language summaries of query results
  • Markdown Formatting: — Creates more readable responses
  • Multiple Model Support: — Works with OpenAI, Azure OpenAI, AWS Bedrock, and Ollama models

Tools it exposes

Once connected, the assistant can call these 2 tools directly:

  • Text2Sql_DatabaseName — Query a specific database using natural language
  • Parameters — - query: Natural language query to execute against the database

Installing the text2sql mcp mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

The server reads 8 environment variables: IGNORE_SCHEMA, MODEL_API_TYPE, AWS_PROFILE, API_VERSION, LLM_MODEL_NAME, EMBED_MODEL_NAME, LOG_LEVEL, FASTMCP_HOST. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Database servers turn schema archaeology and ad-hoc reporting into conversation, which is why they tend to be the second or third server people install. Text2sql MCP sits in that group, and the shape of its toolset — Text2Sql_DatabaseName, Parameters — tells you what it is really for. Worth comparing against the other databases servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This is a hosted server — you point your client at an endpoint rather than running a local process, so there is nothing to keep updated on your machine.
  • Maintained by synechron-code, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the text2sql mcp mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
Text2Sql_DatabaseNameQuery a specific database using natural language
Parameters- query: Natural language query to execute against the database

How to install the Text2sql MCP MCP server

```json
{
  "mcpServers": {
    "text2sql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        ".env",
        "709825985650.dkr.ecr.us-east-1.amazonaws.com/synechron/mcp-text2sql:0.0.10-2025.07.04-rc3",
        "server"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
IGNORE_SCHEMAConfiguration value read at startup.Optional
MODEL_API_TYPEConfiguration value read at startup.Optional
AWS_PROFILEConfiguration value read at startup.Optional
API_VERSIONConfiguration value read at startup.Optional
LLM_MODEL_NAMEConfiguration value read at startup.Optional
EMBED_MODEL_NAMEConfiguration value read at startup.Optional
LOG_LEVELConfiguration value read at startup.Optional
FASTMCP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • Use Text2sql MCP to Text2Sql DatabaseName.
  • Use Text2sql MCP to Parameters.

Frequently asked questions

It connects Text2sql MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 2 tools (Text2Sql_DatabaseName, Parameters) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Text2sql MCP directly.