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)

Open Claude Desktop → Settings → Connectors → Add custom connector.
Connector URL:https://aimodes.ai/api/mcp/http
Complete the browser sign-in and consent flow when prompted.
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:

claude_desktop_config.json

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

Troubleshooting

Consent screen redirects to a login dead-end — Sign into aimodes.aiin your browser first, then re-trigger the connector's authorize flow.
invalid_grant — Remove and re-add the connector to mint a fresh authorization — refresh tokens rotate, so a stale grant must be reconnected.
Tool list is empty after connecting — Check the connector URL ends with /api/mcp/http and that your client speaks streamable HTTP (or uses the mcp-remote bridge below).

ChatGPT (Developer Mode)

Enable Developer Mode in ChatGPT (Settings → Connectors → Advanced).
Add a custom connector with URL:https://aimodes.ai/api/mcp/http
Complete the same browser sign-in and consent flow when ChatGPT prompts.
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.

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

Troubleshooting

Consent screen redirects to a login dead-end — Sign into aimodes.aiin your browser first, then re-trigger the connector's authorize flow.
invalid_grant — Remove and re-add the connector to mint a fresh authorization — refresh tokens rotate, so a stale grant must be reconnected.
Tool list is empty after connecting — Check the connector URL ends with /api/mcp/http and that your client speaks streamable HTTP (or uses the mcp-remote bridge below).

Cursor & Continue (IDE clients)

Cursor and Continue surface MCP tools but not prompts, so /aimodes coachwon'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 beforeconnecting — the OAuth consent screen opens in your default browser, and IDE webviews can't complete sign-in on their own.

Cursor

Add to ~/.cursor/mcp.json (or project .cursor/mcp.json):

~/.cursor/mcp.json

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

Continue

Add to your Continue config.yaml:

config.yaml

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

These snippets use the mcp-remotebridge, 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.

Troubleshooting

Consent screen redirects to a login dead-end — Sign into aimodes.aiin your browser first, then re-trigger the connector's authorize flow.
invalid_grant — Remove and re-add the connector to mint a fresh authorization — refresh tokens rotate, so a stale grant must be reconnected.
Tool list is empty after connecting — Check the connector URL ends with /api/mcp/http and that your client speaks streamable HTTP (or uses the mcp-remote bridge below).

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

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

What the tools do

Tool	What it does	Required scope
`submit_conversation`	Submit a transcript for scoring	submissions.writeSubmit conversations to be scored with AI Modes.
`get_my_scores`	Read recent scores and trends	scores.readView your recent scores, weekly trend, and assignment reminders.
`get_feedback`	Read feedback for past submissions	feedback.readRead personalized feedback for your past submissions.
`explain_mode`	Describe one of the eight AI Modes	modes.readRead short descriptions of the eight AI Modes.
`record_turn`	Classify one turn and track goal drift	submissions.writeSubmit conversations to be scored with AI Modes.
`get_session_directive`	Get a steering directive for this session	scores.readView your recent scores, weekly trend, and assignment reminders.
`mute_coach`	Silence coaching for a set duration	scores.readView your recent scores, weekly trend, and assignment reminders.
`get_my_goal`	Read your weekly tier-mix goal	scores.readView your recent scores, weekly trend, and assignment reminders.
`set_my_goal`	Update your weekly tier-mix goal	scores.readView your recent scores, weekly trend, and assignment reminders.

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).