Back to Docs

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. 1

    Add the FactIQ marketplace

    claude plugin marketplace add defog-ai/factiq-plugin
  2. 2

    Install the plugin

    claude plugin install factiq@factiq
  3. 3

    Reload and select FactIQ

    In Claude Code, run /reload-plugins, then /mcp and select factiq.

  4. 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. 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. 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-plugin and that your network allows Claude Code to reach GitHub.
factiq missing from /mcp
Run /reload-plugins again, or restart Claude Code, then re-run /mcp.
OAuth gets stuck
Sign in to FactIQ in the same browser, then re-run /mcp and select factiq again.
Tools missing in session
FactIQ is enabled per session. Run /mcp and confirm factiq shows as connected. To remove it later, run claude 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.