Connect your own agents to Undermind

Undermind is available as a published ChatGPT app.

If the listing does not open, search for Undermind in ChatGPT’s Plugins directory. Once connected, begin a new chat and type @Undermind.

Open Undermind in Claude’s connector directory. If the button does not open it, paste https://claude.ai/directory/connectors/undermind into your browser.

Connect, sign in to Undermind, and approve access. Then select Undermind from Claude’s Connectors menu in a chat.

This adds Undermind directly to Cursor. Or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "undermind": {
      "type": "http",
      "url": "https://mcp.undermind.ai/mcp",
      "auth": {
        "CLIENT_ID": "cursor"
      }
    }
  }
}

Select Connect next to undermind in Cursor Settings → MCP, or run cursor-agent mcp login undermind in the CLI, and approve the browser connection. If undermind does not appear, restart Cursor once.

Cursor completes sign-in on port 8787. If the browser shows a connection error after approval, close any other program using that port and reconnect. Cursor’s web-based Cloud Agents are not supported yet.

This adds Undermind to VS Code as an MCP server. Or add this to your user mcp.json, opened with MCP: Open User Configuration from the Command Palette:

{
  "servers": {
    "undermind": {
      "type": "http",
      "url": "https://mcp.undermind.ai/mcp",
      "oauth": {
        "clientId": "vscode"
      }
    }
  }
}

Trust the server when asked and approve the browser connection. If VS Code asks for a client ID, use vscode and leave the secret blank. If it does not prompt, run MCP: List Servers and start undermind. One setup covers desktop and remote windows.

Run these commands in a terminal:

codex mcp add undermind --url https://mcp.undermind.ai/mcp --oauth-client-id codex
codex mcp login undermind

Approve the browser connection, then restart Codex. One setup covers the Codex CLI, the IDE extension, and the ChatGPT desktop app’s Codex mode.

Run these commands in a terminal:

claude mcp add --transport http undermind https://mcp.undermind.ai/mcp
claude mcp login undermind

Approve the connection in the browser window that opens. If Safari has trouble completing setup, try Chrome or Edge.

For GitHub Copilot in VS Code, use the VS Code setup above. For the Copilot CLI or desktop app, add this to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "undermind": {
      "type": "http",
      "url": "https://mcp.undermind.ai/mcp",
      "tools": ["*"],
      "oauthClientId": "github-copilot"
    }
  }
}

Run /mcp auth undermind inside Copilot and approve the browser connection. One configuration covers the Copilot CLI and desktop app.

Add this to ~/.config/opencode/opencode.json:

{
  "mcp": {
    "undermind": {
      "type": "remote",
      "url": "https://mcp.undermind.ai/mcp",
      "oauth": {
        "clientId": "opencode"
      }
    }
  }
}

Run opencode mcp auth undermind in a terminal and approve the browser connection.

Choose the plus button at the left of the chat box, then Connectors, Add Connector, and Custom. Name it Undermind and enter this server URL:

https://mcp.undermind.ai/mcp

Then choose Add Connector. Grok asks for the connection details next — enter this client ID and leave the client secret blank:

grok

Then choose Connect and approve the connection in the browser window.

View the official Grok setup guide

Add this as mcp_config.json in ~/.gemini/antigravity/ for the app, ~/.gemini/config/ for the agy CLI, or ~/.gemini/antigravity-ide/ for the IDE. Each reads its own copy.

{
  "mcpServers": {
    "undermind": {
      "serverUrl": "https://mcp.undermind.ai/mcp",
      "oauth": {
        "clientId": "antigravity"
      }
    }
  }
}

Restart Antigravity, select Authenticate next to undermind, and approve the browser connection. Copy the code shown in the browser back into Antigravity.

In Settings → Connectors on a paid plan, add a custom connector and choose streamable HTTP if asked. Enter this server URL:

https://mcp.undermind.ai/mcp

Then enter this client ID, and leave the client secret blank:

perplexity

Select Connect, approve the browser connection, and enable Undermind as a source in your threads.

View the official Perplexity setup guide

Undermind works with any MCP-compatible client. The protocol’s recommended way for a new client to identify itself is a Client ID Metadata Document (CIMD).

To connect:

1. Point the client at https://mcp.undermind.ai/mcp
2. Connect. The client identifies itself; approve access in the browser.

https://mcp.undermind.ai/mcp

If you’re an enterprise, reach out to us at support@undermind.ai and we can help you get this set up. This is typically a very quick setup that does not require much effort on your end.

Your app may still work even if it is not listed. Find where it adds an MCP server, then use this address:

https://mcp.undermind.ai/mcp