factiq

FactIQ - a real-time finance and economy database for AI Agents

Turn your agent into a finance and economy analyst. This plugin for Claude Code and Codex gives the agent direct access to FactIQ's warehouse of official statistics — SEC filings, US, China, India, Korea, IMF, World Bank, and more — plus live market data and earnings-call transcripts. The agent discovers series, runs read-only SQL on FactIQ's database, computes derived metrics, and publishes the result as a shareable FactIQ chart or report, a terminal preview, or a bespoke local HTML visualization.

No codebase or hosted database is required — only a free FactIQ account.

Want to contribute? The highest-leverage addition is a domain playbook that teaches the agent a whole class of questions — see Contributing.

Install

Claude Code

/plugin marketplace add defog-ai/factiq-plugin
/plugin install factiq@factiq
/reload-plugins

Run /reload-plugins after installing so Claude Code picks up the new skill, MCP server, and command in the current session (otherwise they only appear the next time you start Claude Code).

This adds the skill (Claude invokes it automatically for economic/financial data questions), the bundled FactIQ MCP server, and the /factiq:ask command:

Finally, authenticate the MCP server:

1. Run /mcp.
2. Select factiq from the list of servers.
3. Choose Authenticate (or Connect) to open the browser sign-in.
4. Complete the FactIQ login (email, Google, or passkey) and return to Claude Code — the FactIQ tools are now authorized.

Codex

codex plugin marketplace add defog-ai/factiq-plugin
codex plugin add factiq@factiq

Then authorize the MCP server:

codex mcp login factiq

Complete the browser sign-in (the same FactIQ login: email, Google, or passkey). Start a new Codex thread after installation; the skill auto-invokes for economic/financial data questions.

codex plugin marketplace upgrade factiq
codex plugin add factiq@factiq

[mcp_servers.factiq]
url = "https://api.factiq.com/mcp"

claude mcp add --transport http factiq https://api.factiq.com/mcp

Try it

Once installed and authenticated, ask a question:

/factiq:ask How has India's trade deficit with China evolved since 2020?

The agent finds the relevant series, runs the SQL, and replies with a shareable factiq.com chart link — or a terminal chart or full report, depending on what you ask for. You don't need the slash command: any economic or financial data question in a normal Claude Code or Codex conversation auto-invokes the skill.

How it works

Your coding agent is the analyst: it decomposes the question, finds the data, does the math, authors the output, and publishes it — all through tool calls to the FactIQ MCP server (bundled in .mcp.json), which Claude Code and Codex talk to natively over a single OAuth connection.

┌─────────────────────────────┐
│  Claude Code / Codex        │
│  + factiq skill (SKILL.md)  │      the agent orchestrates everything
└──────────────┬──────────────┘
               │  MCP over HTTP (one OAuth connection)
┌──────────────▼──────────────┐
│  FactIQ MCP server          │
│                             │
│  discover   search_datasets, describe_dataset, search_series,
│             get_data_catalog
│  fetch      run_sql (read-only), get_series, get_market_data,
│             search_earnings_transcripts
│  publish    share_chart, share_report
└──────────────┬──────────────┘
               │
┌──────────────▼──────────────┐
│  FactIQ data warehouse      │      ~20 official sources, one schema
│  + factiq.com share pages   │      published charts/reports render here
└─────────────────────────────┘