Text2sql

io.github.cpenniman12

Ask any SQL database in natural language. Agent explores schema, writes SQL, self-corrects.

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.cpenniman12-text2sql-mcp": {4      "command": "uvx",5      "args": [6        "text2sql-mcp==0.1.2"7      ],8      "env": {9        "TEXT2SQL_DATABASE_URL": "<value>",10        "ANTHROPIC_API_KEY": "<secret>",11        "OPENAI_API_KEY": "<secret>",12        "TEXT2SQL_MODEL": "<value>"13      }14    }15  }16}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx text2sql-mcp==0.1.2

Credentials from the publisher

TEXT2SQL_DATABASE_URL — SQLAlchemy connection URL, e.g. sqlite:///mydb.db or postgresql://user:pass@host/db
ANTHROPIC_API_KEY — Anthropic API key (required if using the default Anthropic model)
OPENAI_API_KEY — OpenAI API key (required when TEXT2SQL_MODEL is set to an openai:* model)
TEXT2SQL_MODEL — Optional LangChain model id (default: anthropic:claude-sonnet-4-6)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TEXT2SQL_DATABASE_URL=<value> ANTHROPIC_API_KEY=<secret> OPENAI_API_KEY=<secret> TEXT2SQL_MODEL=<value> claude mcp add io.github.cpenniman12-text2sql-mcp -- uvx text2sql-mcp==0.1.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.cpenniman12-text2sql-mcp": {4      "command": "uvx",5      "args": [6        "text2sql-mcp==0.1.2"7      ],8      "env": {9        "TEXT2SQL_DATABASE_URL": "<value>",10        "ANTHROPIC_API_KEY": "<secret>",11        "OPENAI_API_KEY": "<secret>",12        "TEXT2SQL_MODEL": "<value>"13      }14    }15  }16}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.2
API key: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY, OPENAI_API_KEY, TEXT2SQL_MODEL
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Text2sql?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Text2sql need an API key?

The publisher lists these environment variables: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY, OPENAI_API_KEY, TEXT2SQL_MODEL.

What transport does Text2sql use?

Text2sql runs locally over stdio.

When was Text2sql last checked?

Last checked 2026-10-28. Ask any SQL database in natural language. Agent explores schema, writes SQL, self-corrects.

From the publisher

Documentation

text2sql-mcp

MCP server for text2sql-framework. Plugs into Claude Desktop, Cursor, Goose, or any other MCP-compatible assistant and lets it ask a SQL database questions in natural language.

The agent explores the schema, writes SQL, executes it against the real DB, and self-corrects on errors — no RAG layer, no schema descriptions, no pre-computed embeddings.

Install

Out of the box, text2sql-mcp supports SQLite + Anthropic:

pip install text2sql-mcp
# or
uvx text2sql-mcp

For other databases or LLM providers, install with the matching extra so the right driver gets installed:

You want…	Install command
SQLite (default)	`uvx text2sql-mcp`
Postgres	`uvx 'text2sql-mcp[postgres]'`
MySQL	`uvx 'text2sql-mcp[mysql]'`
Snowflake	`uvx 'text2sql-mcp[snowflake]'`
BigQuery	`uvx 'text2sql-mcp[bigquery]'`
OpenAI models	add `openai`, e.g. `uvx 'text2sql-mcp[postgres,openai]'`

Configure

Set environment variables in your MCP client config:

Variable	Required	Description
`TEXT2SQL_DATABASE_URL`	yes	SQLAlchemy URL, e.g. `sqlite:///mydb.db`, `postgresql://user:pass@host/db`
`ANTHROPIC_API_KEY` or `OPENAI_API_KEY`	yes	LLM provider key
`TEXT2SQL_MODEL`	no	LangChain model id (default: `anthropic:claude-sonnet-4-6`)
`TEXT2SQL_INSTRUCTIONS`	no	Business rules / hints, e.g. "Revenue = net of refunds."
`TEXT2SQL_EXAMPLES`	no	Path to a scenarios.md file for the agent's `lookup_example` tool

Claude Desktop / Cursor / generic MCP

{
  "mcpServers": {
    "text2sql": {
      "command": "uvx",
      "args": ["text2sql-mcp"],
      "env": {
        "TEXT2SQL_DATABASE_URL": "sqlite:///mydb.db",
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

Goose CLI

goose configure
# Add Extension → Command-line Extension
# Name: text2sql
# Command: uvx text2sql-mcp
# Env: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY

Tools

query(question, max_rows=100) — ask the database a natural-language question. Returns {sql, data, error, row_count, tool_calls_made}.

How it works

Under the hood this is a thin wrapper around text2sql-framework, which uses LangChain Deep Agents to do iterative tool-calling against a single execute_sql tool. See the framework README for benchmarks (19/20 on Spider zero-shot across 80 tables) and architecture details.

License

MIT

Text2sql

io.github.cpenniman12

Ask any SQL database in natural language. Agent explores schema, writes SQL, self-corrects.

Databases

Add to Cursor Add to VS Code Run on PlugMCP

GitHub

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.cpenniman12-text2sql-mcp": {4      "command": "uvx",5      "args": [6        "text2sql-mcp==0.1.2"7      ],8      "env": {9        "TEXT2SQL_DATABASE_URL": "<value>",10        "ANTHROPIC_API_KEY": "<secret>",11        "OPENAI_API_KEY": "<secret>",12        "TEXT2SQL_MODEL": "<value>"13      }14    }15  }16}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx text2sql-mcp==0.1.2

Credentials from the publisher

TEXT2SQL_DATABASE_URL — SQLAlchemy connection URL, e.g. sqlite:///mydb.db or postgresql://user:pass@host/db
ANTHROPIC_API_KEY — Anthropic API key (required if using the default Anthropic model)
OPENAI_API_KEY — OpenAI API key (required when TEXT2SQL_MODEL is set to an openai:* model)
TEXT2SQL_MODEL — Optional LangChain model id (default: anthropic:claude-sonnet-4-6)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TEXT2SQL_DATABASE_URL=<value> ANTHROPIC_API_KEY=<secret> OPENAI_API_KEY=<secret> TEXT2SQL_MODEL=<value> claude mcp add io.github.cpenniman12-text2sql-mcp -- uvx text2sql-mcp==0.1.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.cpenniman12-text2sql-mcp": {4      "command": "uvx",5      "args": [6        "text2sql-mcp==0.1.2"7      ],8      "env": {9        "TEXT2SQL_DATABASE_URL": "<value>",10        "ANTHROPIC_API_KEY": "<secret>",11        "OPENAI_API_KEY": "<secret>",12        "TEXT2SQL_MODEL": "<value>"13      }14    }15  }16}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.2
API key: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY, OPENAI_API_KEY, TEXT2SQL_MODEL
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Text2sql?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Text2sql need an API key?

The publisher lists these environment variables: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY, OPENAI_API_KEY, TEXT2SQL_MODEL.

What transport does Text2sql use?

Text2sql runs locally over stdio.

When was Text2sql last checked?

Last checked 2026-10-28. Ask any SQL database in natural language. Agent explores schema, writes SQL, self-corrects.

From the publisher

Documentation

text2sql-mcp

MCP server for text2sql-framework. Plugs into Claude Desktop, Cursor, Goose, or any other MCP-compatible assistant and lets it ask a SQL database questions in natural language.

The agent explores the schema, writes SQL, executes it against the real DB, and self-corrects on errors — no RAG layer, no schema descriptions, no pre-computed embeddings.

Install

Out of the box, text2sql-mcp supports SQLite + Anthropic:

pip install text2sql-mcp
# or
uvx text2sql-mcp

For other databases or LLM providers, install with the matching extra so the right driver gets installed:

You want…	Install command
SQLite (default)	`uvx text2sql-mcp`
Postgres	`uvx 'text2sql-mcp[postgres]'`
MySQL	`uvx 'text2sql-mcp[mysql]'`
Snowflake	`uvx 'text2sql-mcp[snowflake]'`
BigQuery	`uvx 'text2sql-mcp[bigquery]'`
OpenAI models	add `openai`, e.g. `uvx 'text2sql-mcp[postgres,openai]'`

Configure

Set environment variables in your MCP client config:

Variable	Required	Description
`TEXT2SQL_DATABASE_URL`	yes	SQLAlchemy URL, e.g. `sqlite:///mydb.db`, `postgresql://user:pass@host/db`
`ANTHROPIC_API_KEY` or `OPENAI_API_KEY`	yes	LLM provider key
`TEXT2SQL_MODEL`	no	LangChain model id (default: `anthropic:claude-sonnet-4-6`)
`TEXT2SQL_INSTRUCTIONS`	no	Business rules / hints, e.g. "Revenue = net of refunds."
`TEXT2SQL_EXAMPLES`	no	Path to a scenarios.md file for the agent's `lookup_example` tool

Claude Desktop / Cursor / generic MCP

{
  "mcpServers": {
    "text2sql": {
      "command": "uvx",
      "args": ["text2sql-mcp"],
      "env": {
        "TEXT2SQL_DATABASE_URL": "sqlite:///mydb.db",
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

Goose CLI

goose configure
# Add Extension → Command-line Extension
# Name: text2sql
# Command: uvx text2sql-mcp
# Env: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY

Tools

query(question, max_rows=100) — ask the database a natural-language question. Returns {sql, data, error, row_count, tool_calls_made}.

How it works

License

MIT