AI Modes MCP connector

Connect Claude Desktop (or any MCP host that supports remote HTTP and OAuth) to submit conversations for scoring and read your latest scores from inside the assistant.

Claude Desktop (Connectors)

1. Open Claude Desktop → Settings → Connectors → Add custom connector.
2. Connector URL:https://aimodes.ai/api/mcp/httpCopy
3. Complete the browser sign-in and consent flow when prompted.
4. Confirm tools such as submit_conversation, get_my_scores, and record_turn appear in the tool list. To activate the coach loop, type /aimodes coach in your next prompt.

JSON config fallback

If your client reads claude_desktop_config.json, add:

{
  "mcpServers": {
    "aimodes": {
      "url": "https://aimodes.ai/api/mcp/http"
    }
  }
}

ChatGPT (Developer Mode)

Custom MCP connectors need a paid plan (Plus, Pro, Business, Enterprise, or Education). On a Business or Enterprise workspace an admin must first allow them under Workspace Settings → Permissions & Roles → Connected Data → “Create custom MCP connectors.”

1. Turn on Developer Mode: in ChatGPT on the web, open Settings → Apps & Connectors → Advanced settings and switch on Developer mode. (This moved — it is no longer under “Connectors → Advanced.”)
2. Go back to Settings → Apps & Connectors and click Create (or “Add custom connector”). You'll be asked for three things:
   • Name: AI Modes
   • Description: a sentence or two (ChatGPT reads this to decide when to use the tools), e.g. “Logs my AI conversations to AI Modes and returns my engagement scores and coaching.”
   • MCP server URL:
     https://aimodes.ai/api/mcp/httpCopy
3. Click Create. A browser sign-in tab should open — sign into aimodes.ai and approve the connection. If nothing opens, you are almost certainly still on the old path and Developer Mode isn't actually on; recheck step 1. (You must be signed into ChatGPT on the web, not just the desktop app, for the connector UI to appear.)
4. Confirm tools such as submit_conversation, get_my_scores, and record_turn appear in the tool list. To activate the coach loop, type /aimodes coach in your next prompt.
5. After it connects, toggle the tools you want on, and hit Refresh if the tool list looks stale.

ChatGPT Deep Research connectors are intentionally not supported in v1: they require a different search/fetch contract.

Cursor & Continue (IDE clients)

Cursor and Continue surface MCP tools but not prompts, so /aimodes coach won't appear. Drive the loop through the tools directly: call get_my_scores once to surface the _session_protocol notice, then call record_turn after each exchange.

Sign into aimodes.ai in your browser before connecting — the OAuth consent screen opens in your default browser, and IDE webviews can't complete sign-in on their own.

Cursor

Easiest: use Cursor's UI (it opens the file for you)

1. Open the command palette (Cmd/Ctrl+Shift+P) and run “Cursor Settings” (or click the gear icon).
2. Go to Tools & MCP (older builds call it MCP).
3. Click New MCP Server / Add. Cursor opens mcp.json in the editor — paste the snippet below inside it, save, and toggle the aimodes server on.

Or edit the file by hand

The file is ~/.cursor/mcp.json — a hidden .cursor folder in your home directory (global, applies everywhere), or .cursor/mcp.json in a project folder (that project only). It may not exist yet — create it. To open (or create) it:

• Mac: open Terminal and run mkdir -p ~/.cursor && open -e ~/.cursor/mcp.json (opens it in TextEdit, creating it if needed). Or in Cursor: Cmd+O, press Cmd+Shift+. to show hidden files, and navigate to .cursor in your home folder.
• Windows: in Cursor press Ctrl+O and type %USERPROFILE%\.cursor\mcp.json, or run notepad %USERPROFILE%\.cursor\mcp.json in Command Prompt (click Yes to create it).

Paste this as the whole file (or merge the aimodes entry into an existing mcpServers block), then save and restart Cursor:

{
  "mcpServers": {
    "aimodes": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://aimodes.ai/api/mcp/http"]
    }
  }
}

Continue

Add to your Continue config.yaml:

mcpServers:
  - name: aimodes
    command: npx
    args:
      - -y
      - mcp-remote
      - https://aimodes.ai/api/mcp/http

These snippets use the mcp-remote bridge, which wraps the streamable HTTP endpoint for clients that don't connect to remote MCP URLs natively. It also handles the OAuth handoff to your browser.

What the coach does

After you connect AI Modes, type /aimodes coach in your client to activate per-turn coaching for the session. The assistant will classify each turn against the 8-mode AI engagement typology, track drift from your weekly tier-mix goal, and surface labeled nudges. Coaching is opt-in per session, labelled, and mutable.

Activate coaching

1. Type /aimodes coach in any prompt — Claude Desktop, ChatGPT (Dev Mode), Cursor, etc.
2. The assistant will emit [aimodes session started] when activated.
3. Set your weekly goal at Account → Weekly engagement goal.
4. Type "mute coach" in any conversation to silence for 30 minutes.

What the tools do

Weekly retro mode

For a non-intrusive Sunday review, type /aimodes weekly. The assistant pulls your goal and recent scores and walks you through a structured debrief without any per-turn intervention.

Privacy

• Coach classifications stored in mode_history_recent (RLS-scoped to you).
• Conversation text is not stored from record_turn — only mode/tier per turn.
• Pre-send drafts (extension Phase 3, not live yet): text never persisted.

Manage access

Revoke connectors from Account settings → Connected apps (MCP).