IqRush · MCP — Concept Mockup

What is the IqRush MCP server?

MCP is an open standard ("USB-C for AI apps"). Add the IqRush MCP server to Claude, ChatGPT, Cursor or VS Code to reach the IqRush agent layer — alerts, change narratives, recommendations and action items — where you already work. It's a channel for the agents; full evidence stays in RUI.

STEP 1

Generate a key

Create an API key on the API Keys tab.

STEP 2

Add the server

Paste the URL + key into your AI client (see Connect).

STEP 3

Act on it

Ask: "What changed and what should I do next?"

STEP 4

Manage access

Rotate or revoke keys anytime.

You (IqRush)→ API key → AI client→ MCP (Streamable HTTP) → IqRush MCP server→ tier-gated, fenced → Agent layer (acts on RUI)

API keys

Keys authenticate your AI client to the MCP server.

Name	Key	Last used	Expires	Status
Production · Claude	iqr_live_a1b2••••••	2h ago	Never	Active
Cursor · Daniel	iqr_live_9f8e••••••	5d ago	04 Sep 2026	Active
Old test key	iqr_live_22aa••••••	—	Expired	Revoked

Open question for the RFC: are keys owned per organization (shared) or per user? Affects what the MCP can read and how audit logs attribute calls.

Agents

The closed-loop action layer: Detect → Diagnose → Prioritize → Recommend → Assign → Act → Remeasure.

Fence: agents act on measurement and link back to RUI — they don't expose raw evidence/exports. Tier badges: M Monitor · A Analyst · O Operator.

Signal

M

Detect meaningful movement in visibility, citations and competitors; suppress noise.

list_changes()

Diagnosis

M

Explain likely drivers of a change (with confidence) — never claims perfect causality.

get_brief(projectId)

Prioritization

A

Score issues by impact, confidence, effort and urgency. Fewer, better decisions.

list_priorities(projectId)

Recommendation

A

Evidence-linked action plans with expected mechanism and success metric.

list_recommendations(projectId)

Workflow

O

Turn recommendations into assigned, tracked work; approvals; push to Slack/Jira.

create_action_item(...)

Remeasurement

O

Did it work? Trigger a re-run, compare before/after, attribute outcome.

request_remeasurement(...)

Executive Briefing

M

High-level "what changed / why it matters / top actions" for CMOs and agency leads.

get_brief(scope)

Add to your client

The channel — reach the agents from where you work (à la Figma's catalog).

🟣

Claude Code

Remote · read/write

🟢

ChatGPT

Remote · read

⬛

Cursor

Remote · read/write

🔷

VS Code

Remote · read/write

Connect your client

Server URL: https://mcp.iqrush.ai/mcp · Auth: Authorization: Bearer <your key>

{
  "mcpServers": {
    "iqrush": {
      "url": "https://mcp.iqrush.ai/mcp",
      "headers": { "Authorization": "Bearer iqr_live_a1b2c3d4…" }
    }
  }
}

The key is injected from the user's selected API key. Never commit it to git.

🟣

Connect IqRush to Claude Code

Ask about your projects, citations and sentiment from the terminal.

URL https://mcp.iqrush.ai/mcp Transport Streamable HTTP Auth Bearer <key>

1
Get an API key

Create one under Settings → Developers · MCP → API Keys. The full key (iqr_live_…) is shown once — copy it then.
2
Add the server (CLI)
```
claude mcp add --transport http iqrush https://mcp.iqrush.ai/mcp \
  --header "Authorization: Bearer iqr_live_your_key_here"
```
Use -s user to make it available across all projects, or -s project to share it with your team via .mcp.json.
3
Or add it manually (.mcp.json)

Keep the key in an env var so it's never committed:
```
{
  "mcpServers": {
    "iqrush": {
      "type": "http",
      "url": "https://mcp.iqrush.ai/mcp",
      "headers": { "Authorization": "Bearer ${IQRUSH_API_KEY}" }
    }
  }
}
```
Then export IQRUSH_API_KEY="iqr_live_…" in your shell. The file is safe to commit; the secret stays in your environment.
4
Verify
```
claude mcp list        # configured servers
claude mcp get iqrush  # status + details
```
Or run /mcp inside Claude Code — iqrush should be connected with its tools listed.
5
Try it

› Using iqrush, list my projects.

› What's the visibility for "Acme Rebrand" this week?

› Which domains cite us most on Perplexity?

Manage: claude mcp remove iqrush to disconnect. Revoke or rotate the key anytime in API Keys — revoking stops any client instantly.

401 / unauthorized? Key is wrong, expired or revoked — create a fresh one. Mind the space after Bearer.

What is the IqRush MCP server?

API keys

Agents

Add to your client

Connect your client

Connect IqRush to Claude Code

Get an API key

Add the server (CLI)

Or add it manually (.mcp.json)

Verify

Try it

Create API key

Or add it manually (`.mcp.json`)