About vortex-iq
vortex-iq is a read-only connector to VortexIQ, an AI operating system for ecommerce, for users querying store operations through an MCP client. Its tools cover audits, KPIs, alerts, brand guidance, reports, and other workspace data, scoped to the signed-in user's organization and role.
Key features
- 01Query store audits and reports
- 02Review KPIs, alerts, and activity
- 03Access brand profiles and Ask VIQ conversations
- 04Inspect Kanban fixes and reports
- 05Read workspace data without making changes
Use cases
- 01Review recent store audits and findings
- 02Check KPI values and active alerts
- 03Retrieve brand voice guidance and health-fix backlog
MCP support
A remote MCP server using Streamable HTTP, with OAuth 2.1 and PKCE authentication. It exposes 30 read-only tools scoped to the signed-in user's organization.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://app.vortexiq.ai/mcpclaude mcp add --transport http ai-vortexiq-vortex-iq https://app.vortexiq.ai/mcp{"mcpServers":{"ai-vortexiq-vortex-iq":{"type":"http","url":"https://app.vortexiq.ai/mcp"}}}Open in Cursor{"servers":{"ai-vortexiq-vortex-iq":{"type":"http","url":"https://app.vortexiq.ai/mcp"}}}Open in VS Code{"mcpServers":{"ai-vortexiq-vortex-iq":{"type":"http","url":"https://app.vortexiq.ai/mcp"}}}{"mcpServers":{"ai-vortexiq-vortex-iq":{"serverUrl":"https://app.vortexiq.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEVortexIQ MCP Connector
Read-only Model Context Protocol connector for VortexIQ — an AI operating system for ecommerce.
Connect it to Claude (or any MCP client) and ask about your store's health, KPIs, alerts, brand voice, SEO drafts and more — in conversation, scoped to your own VortexIQ workspace. Every tool is read-only: the connector cannot create, edit, delete, publish or send anything.
- Server URL:
https://app.vortexiq.ai/mcp - Transport: Streamable HTTP (remote MCP server)
- Auth: per-user OAuth 2.1 (Authorization Code + PKCE, S256)
- Access: read-only, scoped to the signed-in user's organization
Connect
Claude (web / desktop)
- Settings → Connectors → Add custom connector.
- Server URL:
https://app.vortexiq.ai/mcp - Sign in with your existing VortexIQ (Google) login and click Allow.
- The tools appear in Claude. Try "List my recent store audits."
You need a VortexIQ account. Data returned is scoped to your organization and your role's permissions.
Any OAuth client
The full OAuth 2.1 + PKCE flow (registration, authorize, token, refresh) is documented in MCP_OAUTH_LIVE_USAGE.md. Endpoints are machine-discoverable:
GET https://app.vortexiq.ai/.well-known/oauth-authorization-server
GET https://app.vortexiq.ai/.well-known/oauth-protected-resource
What you can ask
| Prompt | Tools it uses |
|---|---|
"List my recent store audits, then show the findings for integration <id>." | store audit runs → report |
"What KPIs are available, and show the 30-day KPIs for <integration>." | KPI library → integration KPIs |
| "List my active Nerve Centre alerts and the 24h incident summary." | alerts → alert summary |
| "Show my Brand DNA voice/tone guidelines." | brand profile |
| "Show my Kanban health-fix backlog." | kanban board → fix items |
Tools (30, all read-only)
Full per-tool reference lives in docs/tools/ — one page per
tool with parameters, an example prompt, and what it returns.
| Area | Tools |
|---|---|
| Store Audit | list store audit runs · get store audit report · get store audit status |
| Nerve Centre & KPIs | list nerve-centre alerts · get alert summary · list alert activity · get integration KPIs · list KPI library · get nerve integration counts · list nerve-centre profiles · list nerve configurations · list connector catalog · list monitors by type · get dashboard activity feed · list dashboard stores |
| Brand DNA | get brand profile · list brand profiles · list brand ecommerce stores |
| Ask VIQ | list Ask VIQ conversations · get Ask VIQ conversation |
| Kanban (health-fix) | get kanban board · get kanban fix items · get kanban fix status |
| Reports & Insights | list insights reports · list report profiles · list report schedules |
| Inventory & Memory | list CloudHub inventory tabs · list Vortex memory files · list Vortex memory reports |
| Deployments | get deployment history |
Notes & limitations
- Read-only. No write, delete, publish or send tools exist.
- Per-user scope. Each call runs as the connecting user against their own organization's data — there is no shared account.
- Response caps. Some list results are capped (first 50 items / ~40k chars) to stay model-friendly; request a specific id to drill in.
Support
- Docs: https://docs.vortexiq.ai/
- Privacy: https://www.vortexiq.ai/privacy-policy
- Email: [email protected]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.