# vortex-iq

Connects Claude Code and other MCP clients to VortexIQ store data, including audits, KPIs, alerts and Brand DNA. Every tool is read-only.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: veevortexiq
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/veevortexiq/claude-mcp
- Updated: 2026-07-08
- HTML: https://affpapa.org/en/nevibecode/mcp/vortex-iq

## What it does

vortex-iq lets an agent query a VortexIQ workspace through a remote MCP server. It can retrieve store audit runs and reports, integration KPIs, active alerts, Brand DNA profiles, Kanban health-fix items, reports, inventory views and deployment history. Ask VIQ conversations and dashboard activity are available too.

The connector uses Streamable HTTP with OAuth 2.1 and PKCE. Requests stay within the signed-in user’s organization and permissions, so there is no shared account. Some list responses stop at the first 50 items or about 40k characters; a specific ID is needed to inspect an entry further.

A VortexIQ account is required before connection can finish. The server cannot create, edit, delete, publish or send anything.

## Requirements
- Remote server: `https://app.vortexiq.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http vortex-iq https://app.vortexiq.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add vortex-iq --url https://app.vortexiq.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vortex-iq": {
            "url": "https://app.vortexiq.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vortex-iq": {
            "type": "http",
            "url": "https://app.vortexiq.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http vortex-iq https://app.vortexiq.ai/mcp
```

## When to use it
- inspect recent store audits and their findings
- retrieve KPIs for a chosen integration
- review active alerts and an incident summary
- check Brand DNA voice and tone guidance
- find health-fix items on the Kanban board

## Example prompts
- List the latest store audits, then show findings for integration `<id>`.
- Tell me which KPIs are available and show the 30-day figures for `<integration>`.
- Show active alerts and the incident summary for the last 24 hours.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md