nlqdb — Claude Code MCP server: setup
Connects an AI agent to a database over MCP so it can answer analytical questions in plain English. Useful when database work should stay inside the coding workflow.
claude mcp add --transport http nlqdb https://mcp.nlqdb.com/mcpWhat nlqdb — analytical memory for AI agents does
nlqdb connects an AI agent to its hosted MCP server and lets the agent query a database in plain English. It works with Postgres and Cloudflare D1: the response includes the SQL that ran and a confidence signal, so the generated answer can be checked.
Claude Code can connect over HTTP, while Codex, Cursor, GitHub Copilot, and Gemini CLI have their own setup forms. A headless MCP host can run npx -y @nlqdb/mcp with an sk_mcp_* key; other hosts use browser OAuth approval.
Natural-language-to-SQL results can still be wrong. Check the SQL and confidence signal before relying on an answer, especially when the query informs a database decision.
What it helps with
- connect an AI agent to a database over MCP
- ask analytical questions in plain English
- inspect the SQL produced for an answer
- check confidence for a generated result
- run the local MCP server on a headless host
Example prompts for the agent
- Ask the database for the 5 newest orders and include their customers and items.
- Show the SQL used for this order analysis and report the confidence signal.
- Connect to the database over MCP and find records matching this condition.
How to install nlqdb — analytical memory for AI agents
Platform CLI: remote server
claude mcp add --transport http nlqdb https://mcp.nlqdb.com/mcpPlatform CLI: remote server
codex mcp add nlqdb-analytical-memory-for-ai-agents --url https://mcp.nlqdb.com/mcpConfig file
{
"mcpServers": {
"nlqdb-analytical-memory-for-ai-agents": {
"url": "https://mcp.nlqdb.com/mcp"
}
}
}Config file
{
"servers": {
"nlqdb-analytical-memory-for-ai-agents": {
"type": "http",
"url": "https://mcp.nlqdb.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http nlqdb-analytical-memory-for-ai-agents https://mcp.nlqdb.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about nlqdb — analytical memory for AI agents
How do I install nlqdb in Claude Code?
Run claude mcp add --transport http nlqdb https://mcp.nlqdb.com/mcp, then run claude mcp add --transport http nlqdb-analytical-memory-for-ai-agents https://mcp.nlqdb.com/mcp.
What does nlqdb do?
It gives an AI agent an MCP connection for plain-English database queries. Each response includes the executed SQL and a confidence signal.
What is required on a headless MCP host?
Run npx -y @nlqdb/mcp with an sk_mcp_* key. Other MCP hosts use a browser OAuth approval during connection.
