# CorpusIQ MCP server

> Answer business questions from connected sources like QuickBooks, GA4, Google Ads and Shopify with read-only retrieval and citations.

- Listing: https://mcp.tc/i/corpusiq
- Connect: use the server's own URL `https://mcp2.corpusiq.io/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: OAuth sign-in
- Category: [Data & Analytics](https://mcp.tc/c/analytics)
- Vendor: CorpusIQ LLC

## About

CorpusIQ connects an assistant to business data in tools such as QuickBooks, GA4, Google Ads, Meta Ads, Slack and YouTube. It offers per-source connectors, cross-source analysis of ads, email and web traffic, runbooks and skills for broad questions like a financial snapshot, and stored canonical facts, decisions and metric specs.

It runs as a hosted streamable HTTP endpoint at https://mcp2.corpusiq.io/mcp. Users connect through an OAuth sign-in and need a CorpusIQ account, which has a 30-day trial. Retrieval from connected sources is read-only.

## What it can do

- Ask business questions routed to connected sources with cited answers
- Query QuickBooks, GA4, Google Ads, Meta Ads and Slack through connectors
- Correlate ad spend with web traffic and revenue across sources
- Run server-side runbooks for executive financial snapshots
- Search YouTube videos, channels, comments and transcripts
- Store canonical business facts, decisions and metric specs, with confirmation before…

## Tools (121)

- `get_connector_status`: Show a dashboard of each configured connector's status. (read-only)
- `resolve_connector`: Work out how to answer a data question; called first for data requests. (read-only)
- `ask_corpusiq`: Answer a business question through a deterministic server-side runbook. (read-only)
- `select_runbook`: Pick the best runbook for a broad executive question. (read-only)
- `list_runbooks`: Browse a compact list of runbooks. (read-only)
- `run_runbook`: Run a runbook by id, returning a playbook or a server-side result. (read-only)
- `list_skills`: Browse a compact list of cross-source skills. (read-only)
- `invoke_skill`: Fetch a named skill playbook by id. (read-only)
- `cross_source_ads_connector`: Correlate Google Ads spend with GA4 traffic and revenue. (read-only)
- `cross_source_email_connector`: Correlate Klaviyo email activity with traffic, revenue and ad spend. (read-only)
- `canonical_context_get`: Read declared canonical facts, recent decisions and metric specs. (read-only)
- `canonical_facts_get`: Get one declared canonical business fact by key. (read-only)
- `canonical_facts_list`: List canonical facts, optionally by category. (read-only)
- `canonical_facts_set`: Prepare a canonical fact write pending user confirmation.
- `canonical_decisions_add`: Prepare an entry for the decisions log pending confirmation.
- `canonical_decisions_list`: List recent canonical decisions. (read-only)
- `canonical_pending_commit`: Commit a pending write after explicit user confirmation. (can modify or delete data)
- `canonical_pending_cancel`: Cancel a pending canonical write. (can modify or delete data)
- `truth_sources_list`: List registered source-of-truth document entries. (read-only)
- `truth_sources_register`: Prepare to register a source-of-truth entry.
- `truth_sources_remove`: Prepare to remove a source-of-truth entry.
- `metric_spec_list`: List declared metric specs. (read-only)
- `metric_spec_get`: Fetch one metric spec with its full declaration. (read-only)
- `metric_spec_set`: Prepare to save a new or updated metric spec.
- `metric_spec_remove`: Prepare to delete a metric spec.
- `metric_spec_resolve`: Compute a metric spec live with its source-call ledger. (read-only)
- `metric_spec_drift_report`: Report specs whose cross-source checks disagree. (read-only)
- `ga4_connector`: Query GA4 traffic, sessions, conversions and revenue. (read-only)
- `quickbooks_connector`: Query QuickBooks financial reports, invoices and payments. (read-only)
- `meta_ads_connector`: Query Facebook and Instagram ad performance. (read-only)
- `google_ads_connector`: Query Google Ads campaigns, keywords and spend. (read-only)
- `slack_connector`: Read Slack channels, messages, threads and files. (read-only)
- `get_my_youtube_analytics`: Get analytics for the user's YouTube channel. (read-only)
- `get_my_youtube_videos`: List the user's uploaded YouTube videos. (read-only)
- `search_youtube`: Search YouTube videos by query. (read-only)
- `get_youtube_video`: Get details for one or more YouTube videos. (read-only)
- `get_youtube_transcript`: Get the transcript of a YouTube video. (read-only)
- `get_youtube_channel`: Look up a YouTube channel by ID or handle. (read-only)
- `get_youtube_channel_videos`: Get recent videos from a YouTube channel. (read-only)
- `get_youtube_comments`: Get top-level comments on a YouTube video. (read-only)
- `get_my_youtube_channel`: Get the authenticated user's own YouTube channel details (title, subscriber count, video count, views). (read-only)
- `list_my_youtube_channels`: List YouTube channels the authenticated user owns or manages. (read-only)
- `get_my_youtube_video_analytics`: Get detailed analytics for a specific video owned by the authenticated user. (read-only)
- `get_my_youtube_geography`: Get geographic viewer breakdown for the authenticated user's channel or a specific video. (read-only)
- `add_my_youtube_brand_channel`: Register a YouTube Brand Account channel for the authenticated user. (can modify or delete data)
- `remove_my_youtube_brand_channel`: Drop a registered YouTube Brand Account channel from the user's registrations. (can modify or delete data)
- `set_my_primary_youtube_channel`: Change which already-registered Brand Account is the user's primary. (can modify or delete data)
- `tiktok_connector`: TikTok account and video analytics: profile stats, video performance, engagement metrics (views, likes, shares, comments). (read-only)
- `ebay_connector`: eBay seller data: orders, transactions, seller standards, customer service metrics, traffic reports, and funds summary. (read-only)
- `klaviyo_connector`: Email and SMS marketing automation: campaigns, flows, abandoned cart, list growth, subscriber health, conversion metrics, and revenue attribution. (read-only)
- `mailchimp_connector`: Mailchimp email marketing: campaigns, lists, subscribers, open rates, click rates, and audience growth. (read-only)
- `constantcontact_connector`: Constant Contact email marketing: contacts, email campaigns, lists, and engagement metrics. (read-only)
- `activecampaign_connector`: ActiveCampaign email marketing and CRM: contacts, lists, campaigns, automations, deals, and tags. (read-only)
- `odoo_connector`: Odoo ERP/CRM data: partners (contacts and companies), sale orders, CRM leads and opportunities, customer/vendor invoices, products, on-hand inventory, stock transfers, accounting journals, payments, taxes, employees… (read-only)
- `amazon_seller_connector`: Amazon Seller Central data: orders, inventory, sales metrics, and seller account performance. (read-only)
- `airtable_connector`: Airtable bases, tables, and records: browse, search, and retrieve structured data from Airtable databases. (read-only)
- `calendly_connector`: Calendly scheduling data: scheduled events, event types, invitee lists, and user availability. (read-only)
- `monday_connector`: Monday.com project and work management data: workspaces, boards, groups, columns, items, rows, pulses, owners, statuses, dates, blockers, and column values. (read-only)
- `search_console_connector`: SEO and search performance: clicks, impressions, CTR, position, sitemaps, URL inspection, and indexed page status from Google Search Console. (read-only)
- `postscript_connector`: PostScript SMS marketing: subscribers, keywords, and shop analytics for Shopify merchants. (read-only)
- `connect_gunbroker`: Connect your GunBroker seller account. (read-only)
- `get_gunbroker_connection_status`: Check whether GunBroker credentials are configured for the current user. (read-only)
- `disconnect_gunbroker_connection`: Remove stored GunBroker credentials and disconnect the account. (can modify or delete data)
- `search_gunbroker_items`: Search GunBroker marketplace listings by keyword, category, price range, or condition. (read-only)
- `get_gunbroker_item`: Fetch full listing details for a single GunBroker item by ID - price, bids, watchers, seller, condition, and description. (read-only)
- `list_gunbroker_categories`: List GunBroker item categories or subcategories. (read-only)
- `find_gunbroker_ffl_by_zip`: Find Federal Firearms Licensee (FFL) dealers near a buyer ZIP code. (read-only)
- `list_gunbroker_items_sold`: List items the authenticated GunBroker seller sold within the last N days. (read-only)
- `list_gunbroker_items_selling`: List the authenticated seller currently active GunBroker listings - title, current price, bid count, watchers, and end date. (read-only)
- `get_gunbroker_inventory_summary`: Return aggregate counts for the authenticated seller active GunBroker listings. (read-only)
- `list_gunbroker_items_unsold`: List the authenticated seller's expired (unsold) GunBroker listings within the last N days. (read-only)
- `list_gunbroker_items_scheduled`: List GunBroker listings the authenticated seller has scheduled but not yet launched. (read-only)
- `list_gunbroker_watched_items`: List GunBroker listings the authenticated user is watching. (read-only)
- `list_gunbroker_orders`: List GunBroker orders for the authenticated seller within the last N days - buyer info, item, amount, and fulfillment status. (read-only)
- `get_gunbroker_order`: Fetch full details for a single GunBroker order - buyer, item, payment, shipping, and FFL transfer details. (read-only)
- `list_gunbroker_feedback`: List feedback received by the authenticated GunBroker seller within the last N days - rating, comment, and buyer. (read-only)
- `list_gunbroker_fraud_claims`: List open fraud or dispute claims associated with the authenticated GunBroker seller account. (read-only)
- `get_gunbroker_account_summary`: Fetch the authenticated user GunBroker account profile, seller ratings, and account standing. (read-only)
- `get_gunbroker_billing_summary`: Fetch recent GunBroker billing and fee records for the authenticated seller - listing fees, final value fees, and account charges. (read-only)
- `semrush_connector`: Semrush SEO platform: domain overview, organic and paid keywords, competitor analysis, backlinks, and keyword research. (read-only)
- `ahrefs_connector`: Ahrefs SEO platform: domain rating, backlink analysis, organic keywords, referring domains, competitor research, top pages by traffic, and keyword research. (read-only)
- `web_fetch_connector`: Grounded public-web retrieval: fetch any public web page and return its cleaned text, title, and description, each cited to the source URL and timestamped. (read-only)
- `posthog_connector`: PostHog product analytics: account/project info, raw events, person records, event definitions, HogQL queries, and funnel conversion analysis. (read-only)
- `stripe_connector`: Stripe payments platform: account profile, charges, customers, payouts, balance transactions, refunds, disputes, and balance. (read-only)
- `axonaut_connector`: Axonaut French all-in-one business management (CRM + invoicing + accounting): companies (third parties), quotations, invoices, opportunities (CRM pipeline), expenses, payments, suppliers, products, contracts… (read-only)
- `notion_connector`: Notion workspace: read pages, databases, blocks, and users. (read-only)
- `linkedin_ads_connector`: LinkedIn Marketing API (Ads): sponsored ad accounts, campaigns, creatives, and daily performance analytics (impressions, clicks, costInLocalCurrency, conversions). (read-only)
- `close_connector`: Close CRM sales platform: leads, opportunities (pipeline deals), activities (calls/emails/notes/meetings), full-text search, and organization users (sales reps). (read-only)
- `salesforce_connector`: Salesforce CRM read access via the CorpusIQ breadth tier (sourced through Arcade, not a first-party connector). (read-only)
- `github_connector`: Read-only GitHub delivery assessment, release forecasting, quality trends, scalar quality metrics, and a native PNG dashboard with explicit evidence completeness. (read-only)
- `bing_webmaster_connector`: Bing Webmaster Tools (Microsoft) organic-search data for a verified site: rank & traffic stats (impressions/clicks over time), top search queries with positions, per-URL index & traffic detail, crawl statistics… (read-only)
- `callrail_connector`: CallRail call-tracking read access via the CorpusIQ breadth tier (sourced through Nango, not a first-party connector). (read-only)
- `podium_connector`: Podium read access via the CorpusIQ breadth tier (sourced through Nango, not a first-party connector). (read-only)
- `shopline_connector`: SHOPLINE ecommerce data: store profile, orders, refunds, products, inventory, locations, customers, returns, fulfillment orders, and discount-code price rules. (read-only)
- `email_connector`: Email messages across Gmail and Outlook: read, search, and list emails from any connected inbox. (read-only)
- `calendar_connector`: Calendar events across Google Calendar and Outlook: list upcoming meetings, search events, check availability. (read-only)
- `drive_connector`: File storage across Google Drive, OneDrive, and Dropbox: list, search, and read user-uploaded documents, spreadsheets, PDFs, and other files. (read-only)
- `crm_connector`: Customer relationship management across HubSpot and LeadConnector: contacts, deals, pipelines, companies, and sales opportunities. (read-only)
- `chart_render`: Render numeric data as a deterministic CorpusIQ PNG plus a complete text summary. (read-only)
- `dashboard_render`: Fetch live Google Analytics 4 data and return an evidence-backed CorpusIQ PNG recap plus accessible text, structured values, reconciliation status, and an integrity receipt. (read-only)
- … and 21 more on the listing page.

## Example prompts

- "Give me an executive financial snapshot of my business."
- "Compare my Google Ads spend to GA4 sessions and conversions last month."
- "Which QuickBooks invoices are overdue?"
- "Show the metric spec for MRR and resolve it now."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http corpusiq https://mcp2.corpusiq.io/mcp
```

2. Start Claude Code, type `/mcp`, pick **corpusiq** and choose **Authenticate**. A browser window opens for the CorpusIQ LLC sign-in.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **CorpusIQ** and paste this URL:

```url
https://mcp2.corpusiq.io/mcp
```

3. Click **Add**, then **Connect**, and sign in when CorpusIQ LLC asks.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=CorpusIQ&connectorUrl=https%3A%2F%2Fmcp2.corpusiq.io%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://mcp2.corpusiq.io/mcp` and click **Add**.

3. Click **Connect** and sign in when CorpusIQ LLC asks.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://mcp2.corpusiq.io/mcp` as the server URL, then for authentication choose **OAuth**. ChatGPT sends you to CorpusIQ LLC to sign in.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=corpusiq&config=eyJ1cmwiOiJodHRwczovL21jcDIuY29ycHVzaXEuaW8vbWNwIn0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "corpusiq": {
      "url": "https://mcp2.corpusiq.io/mcp"
    }
  }
}
```

Cursor shows **Needs authentication** next to the server. Click the button beside it to sign in.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=corpusiq&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp2.corpusiq.io%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"corpusiq","type":"http","url":"https://mcp2.corpusiq.io/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "corpusiq": {
      "type": "http",
      "url": "https://mcp2.corpusiq.io/mcp"
    }
  }
}
```

VS Code asks you to sign in the first time the server starts.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "corpusiq": {
      "serverUrl": "https://mcp2.corpusiq.io/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade and sign in when asked.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add corpusiq --url https://mcp2.corpusiq.io/mcp
codex mcp login corpusiq
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.corpusiq]
url = "https://mcp2.corpusiq.io/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http corpusiq https://mcp2.corpusiq.io/mcp
```

Then, inside Gemini CLI, run `/mcp auth corpusiq` to sign in.

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "corpusiq": {
      "type": "http",
      "url": "https://mcp2.corpusiq.io/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp2.corpusiq.io/mcp`.

## Recent changes

- 2026-11-19 14:23 UTC: Tracking started: 121 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/corpusiq#history (Atom feed: https://mcp.tc/i/corpusiq/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 1.0.0
- MCP protocol version: 2025-03-26
- Last checked: 2026-11-22 (reachable, asks for credentials)
- Listed: 2026-11-19
- Updated: 2026-11-19

---
Source: https://mcp.tc/i/corpusiq (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
