Back to Browse

Factql MCP Server

by Factql
Developer ToolsLow Risk8.0MCP RegistryLocalRemote
Free

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

8.0
Low Risk8.0Low Risk

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.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

FactQL API key (an ask-only key is enough)Required

Environment variable: FACTQL_API_KEY

FactQL API base URLOptional

Environment variable: FACTQL_BASE_URL

Default workspace, for tenants that use workspacesOptional

Environment variable: FACTQL_WORKSPACE_ID

Who is asking; defaults to mcp:<os user>Optional

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 GitHub

From 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

VariableRequiredDefault
FACTQL_API_KEYyes— your FactQL API key (an ask-only key is enough)
FACTQL_BASE_URLnohttps://api.factql.ai
FACTQL_WORKSPACE_IDnodefault workspace, for tenants that use workspaces
FACTQL_END_USER_IDnomcp:<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. A needs_clarification result means the question was too vague; ask the user and call again with the detail. A declined result means FactQL couldn't verify an answer and gave none rather than guess; the reason says why. locale is en-GB or en-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!