Skip to main content

Query Tools (/mcp/query)

The tools available at the /mcp/query endpoint focus on database exploration, schema discovery, and data retrieval.

Core Database Tools

ToolDescription
list_schemasLists all available database schemas.
list_tablesLists all tables in a specific schema.
get_constraintsRetrieves primary and foreign key constraints.
run_sql_readonlyExecutes a SQL query in read-only mode.
explain_sqlGenerates an execution plan for a SQL query.

Discovery & Catalog Tools

ToolDescription
discovery.run_staticTriggers a harvest of database metadata.
catalog.initInitializes the MCP catalog.
catalog.searchFull-text search over discovered tables and columns.
catalog.get_objectFetches details for a specific table or view.
catalog.list_objectsLists all discovered objects in the catalog.
catalog.get_relationshipsLists relationships between tables.

LLM Context & Agent Management

ToolDescription
agent.run_startStarts a new tracking run for an AI agent.
agent.run_finishMarks an agent run as complete.
agent.event_appendAppends a log event to an agent run.
llm.summary_upsertStores an LLM-generated summary for a database object.
llm.note_addAdds a specific note or observation about the schema.
llm.searchSemantic search over LLM-generated summaries and notes.

Specialized Tools

ToolDescription
suggest_joinsSuggests potential joins between tables based on catalog metadata.
stats.get_tool_usageRetrieves performance statistics for MCP tools.