Add FactIQ to Claude Code
Requires Claude Code — included with paid Claude plans (Pro, Max, Team, or Enterprise) and API accounts·FactIQ is free to start
Set up: local sessions
One install from any terminal covers the CLI, the desktop app, and IDE extensions on your machine.
- 1
Add the FactIQ marketplace
claude plugin marketplace add defog-ai/factiq-plugin - 2
Install the plugin
claude plugin install factiq@factiq - 3
Reload and select FactIQ
In Claude Code, run
/reload-plugins, then/mcpand selectfactiq. - 4
Connect your FactIQ account
Finish the browser sign-in. Email, Google, and passkey all work.
Set up: cloud sessions (web or desktop)
Cloud sessions run on Anthropic infrastructure and don’t see plugins installed on your machine. Enable FactIQ per repository instead.
- 1
Declare the plugin in your repo
Add this to the repository's checked-in
.claude/settings.json:{ "extraKnownMarketplaces": { "factiq": { "source": { "source": "github", "repo": "defog-ai/factiq-plugin" } } }, "enabledPlugins": { "factiq@factiq": true } } - 2
Start a cloud session in that repo
The plugin installs at session start. Complete the FactIQ sign-in when prompted.
Try it
Ask a data question normally, or run /factiq:ask <question> to force the full FactIQ workflow.
- For Nvidia’s latest covered earnings call, identify the most decision-relevant management claims and Q&A pressure points. For claims, return verbatim quotes with speaker/role, section, call date, fiscal period, and citations. For pressure points, label the returned quote as a composite analyst-ask/management-response excerpt and include the analyst firm when available, specific ask, response quality, any refused number, call date, fiscal period, and citation; do not infer unavailable speaker names or roles. Report coverage gaps and cap hits.
- Test Walmart management’s consumer trade-down claims against US retail sales, CPI, real earnings, and consumer-credit data. Separate source evidence from inference and say what would falsify the conclusion.
- Chart US unemployment and labor-force participation since 2000. State the series IDs, frequency, seasonal adjustment, observation range, and sources.
For coverage checks, batching, evidence rules, and stronger prompt patterns, read how to get better results.
Troubleshooting
- Marketplace add fails
- Confirm the marketplace name is exactly
defog-ai/factiq-pluginand that your network allows Claude Code to reach GitHub. - factiq missing from /mcp
- Run
/reload-pluginsagain, or restart Claude Code, then re-run/mcp. - OAuth gets stuck
- Sign in to FactIQ in the same browser, then re-run
/mcpand selectfactiqagain. - Tools missing in session
- FactIQ is enabled per session. Run
/mcpand confirmfactiqshows as connected. To remove it later, runclaude plugin uninstall factiq. - Installed in the Claude app instead?
- Claude and Claude Code plugins are separate systems — installing FactIQ in Claude chat doesn’t make it available in Claude Code, or the other way around.