Server data from the Official MCP Registry
Verified answers from your data, with the query and rows behind them, or a decline, never a guess.
About
Verified answers from your data, with the query and rows behind them, or a decline, never a guess.
Remote endpoints: streamable-http: https://api.factql.ai/mcp
Security Report
Valid MCP server (1 strong, 2 medium validity signals). 4 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.
Endpoint verified · Requires authentication · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: FACTQL_API_KEY
Environment variable: FACTQL_BASE_URL
Environment variable: FACTQL_WORKSPACE_ID
Environment variable: FACTQL_END_USER_ID
How to Install & Connect
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
Documentation
View on GitHubFrom the project's GitHub README.
factql-mcp
FactQL is the harness around the model.
Ask a question about your data. FactQL runs the query, checks the result before you see an answer, and declines instead of guessing when it can't verify.
Every answer ships with the query that ran, the rows it returned and the lineage behind it. One API call. Works with Postgres, MySQL, DuckDB, uploaded CSV and XLSX files, and PDFs with cited answers.
Built for developers putting AI near real data: AI apps, agents and internal tools that can't afford a confident wrong number.
This package is FactQL's MCP server: it brings those answers into Claude Desktop, Claude Code, Cursor, or any MCP client. Learn more at factql.ai.
Hosted server (no install)
FactQL also runs this server for you at:
https://api.factql.ai/mcp
Add it as a remote (Streamable HTTP) MCP server in Claude (Settings → Connectors → Add custom connector; works on web, desktop and mobile), Claude Code (claude mcp add --transport http factql https://api.factql.ai/mcp), Cursor, VS Code, or any app that supports remote MCP. The app opens a FactQL sign-in page; click Allow and its questions run as you. Disconnect under Settings → Connected apps on factql.ai. Apps that can't sign in can send an API key as Authorization: Bearer fl_live_... instead.
Setup for each app: docs.factql.ai/guides/mcp.
The rest of this README is for running the server yourself.
Get a key
Sign up free at factql.ai/signup, connect your data, and create an API key. An ask-only key is enough for this server.
Install
uvx factql-mcp
or pip install factql-mcp.
Configure
| Variable | Required | Default |
|---|---|---|
FACTQL_API_KEY | yes | — your FactQL API key (an ask-only key is enough) |
FACTQL_BASE_URL | no | https://api.factql.ai |
FACTQL_WORKSPACE_ID | no | default workspace, for tenants that use workspaces |
FACTQL_END_USER_ID | no | mcp:<os user> |
Claude Desktop / Cursor (mcpServers)
{
"mcpServers": {
"factql": {
"command": "uvx",
"args": ["factql-mcp"],
"env": { "FACTQL_API_KEY": "fl_live_..." }
}
}
}
Claude Code
claude mcp add factql -e FACTQL_API_KEY=fl_live_... -- uvx factql-mcp
Tools
whoami()— the tenant, plan, and workspaces this key can query.ask(question, workspace_id?, locale?)— the answer, the SQL that ran, and up to 50 rows. Aneeds_clarificationresult means the question was too vague; ask the user and call again with the detail. Adeclinedresult means FactQL couldn't verify an answer and gave none rather than guess; thereasonsays why.localeisen-GBoren-US.
Each ask is stateless: the MCP client carries the conversation, so a follow-up should restate what it refers to.
Safety
FactQL only runs SELECT queries, under a statement timeout, and only against the tables your admin has enabled. The key's permissions decide what it can see; this server adds nothing on top.
Development
uv run --with pytest pytest -q
License
MIT
Questions and feedback
Ask in Discussions or email ask@factql.ai. Bugs go in Issues.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
