Skip to main content
Glama
cpenniman12

text2sql-mcp

by cpenniman12

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OPENAI_API_KEYNoOpenAI API key
TEXT2SQL_MODELNoLangChain model idanthropic:claude-sonnet-4-6
ANTHROPIC_API_KEYNoAnthropic API key
TEXT2SQL_EXAMPLESNoPath to a scenarios.md file
TEXT2SQL_DATABASE_URLYesSQLAlchemy URL for the database
TEXT2SQL_INSTRUCTIONSNoBusiness rules or hints

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
queryA

Ask the database a natural-language question.

The agent explores the schema, writes SQL, executes it, and self-corrects on errors before returning. Read-only — only SELECT-style statements.

Args: question: The natural-language question, e.g. "top 5 customers by revenue". max_rows: Cap on rows returned in data. Defaults to 100.

Returns: dict with: sql: the final verified SQL data: list of row dicts (capped at max_rows) error: error message if execution failed, else None row_count: number of rows in data tool_calls_made: how many SQL calls the agent made while exploring

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.7/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of confusion between overlapping functions. The tool's purpose is clearly defined for natural-language database queries, making selection trivial.

Naming Consistency5/5

The single tool named 'query' is simple, intuitive, and uses a clear verb form. While there is no pattern to compare, the naming is unambiguous and follows common conventions for a query action.

Tool Count3/5

The server has just one tool, which feels thin for a database interaction service. However, the tool is comprehensive and handles schema exploration, SQL generation, execution, and self-correction internally, so it may be sufficient for its narrow scope.

Completeness5/5

The tool covers the full natural-language query lifecycle: it interprets the question, writes SQL, executes it, and returns results with error handling. As a read-only query tool, it fully addresses the stated purpose without obvious gaps.

Maintenance

ActivitySlowing
ResponsivenessNo issues