# Cortex MCP · Use Cortex from Claude, ChatGPT or Gemini

> Connect Cortex to your AI assistant in 30 seconds: mock exams, weak points and study plans from Claude, ChatGPT, Gemini, Cursor or VS Code. No API key.

Web page: https://cortexexam.com/mcp · Version française: https://cortexexam.com/mcp-fr.md · Updated 16 November 2026

Connect Cortex once. Then ask for a mock exam, your weak points or a study plan in plain words: your assistant runs it in your own Cortex account, on your courses and past exams.

## Server

- **URL**: `https://app.cortexexam.com/mcp`
- **Transport**: Streamable HTTP
- **Authentication**: OAuth 2.1 with the user's Cortex account (dynamic client registration, discovery from `https://app.cortexexam.com/.well-known/oauth-protected-resource/mcp`). No API key, no header.
- **Server card**: [https://cortexexam.com/.well-known/mcp/server-card.json](https://cortexexam.com/.well-known/mcp/server-card.json)

## For AI assistants: install Cortex for the user

```text
Set up the Cortex MCP server for me.
1. Read the official guide: https://cortexexam.com/mcp.md
2. Add the remote MCP server https://app.cortexexam.com/mcp to the app you are running in, named "cortex", with the method the guide gives for that app (Streamable HTTP, OAuth, no API key).
3. If you can't change your own settings, give me the exact steps for this app instead.
4. When the browser opens, I'll sign in with my Cortex account.
5. Then check it works: call get_account_status and list_courses, and tell me what you see.
Never confirm a paid tool for me: tell me its cost and wait for my yes.
```

## Ask in your own words

Your assistant picks the right Cortex tool. A few things students ask:

- “Generate a mock exam for CS-233, same format as the finals.” → `generate_mock_exam` (credits)
- “What are my weak points?” → `get_weak_points` (free)
- “Add this PDF to my CS-233 course.” → `add_course_source` (free)
- “What should I revise before Friday?” → `get_study_plan` (free)
- “Give me an exam-style question on kernels, then grade my answer.” → `generate_drill`, `check_answer` (credits)
- “Where is the proof of the spectral theorem in the slides?” → `search_course_materials` (free)
- “How many credits do I have left?” → `get_account_status` (free)
- “Create a MATH-111 course and add last year's exams.” → `create_course`, `add_course_source`, `prepare_course` (credits)

## Connect in 30 seconds

The same address works everywhere. Pick your assistant.

### Claude

*Where*: claude.ai, Claude Desktop and the Claude mobile apps. Every plan, Free included (one custom connector on Free).

1. On **claude.ai** or in **Claude Desktop**, open **Customize → Connectors**.
2. Click **+ Add**, then **Add custom connector**.
3. Name it **Cortex** and paste the server address:

   ```
   https://app.cortexexam.com/mcp
   ```

4. Choose **Sign in now**, leave the other options as they are, then click **Add**.
5. Sign in with your Cortex account and allow access.
6. In a chat, check that Cortex is on in the tools menu, then ask.

Team or Enterprise: an owner adds it once in **Organization settings → Connectors → Add → Custom → Web**, then each member clicks **Connect**. On your phone: add it once on the web, then use it from the Claude app.

### ChatGPT

*Where*: ChatGPT on the web (chatgpt.com). Business, Enterprise and Edu: an admin may have to allow custom MCP servers. Plus and Pro: OpenAI may limit custom servers to read-only tools.

1. Open **Plugins**, click **+**, then **Add custom MCP server**. On a personal plan, if that option is missing, first turn on **Developer mode** in **Settings → Security and login**.
2. Name it **Cortex**. Under **Connection**, paste the server URL:

   ```
   https://app.cortexexam.com/mcp
   ```

3. Set authentication to **OAuth**, tick **I understand and want to continue**, then click **Create**.
4. Sign in with your Cortex account when ChatGPT asks.
5. In a chat, type **@** and pick Cortex.

ChatGPT asks before each write action, and Cortex announces the cost of any generation before it runs. If your plan only allows read-only tools, you still get your plan, weak points, results and search; generate in the app.

### Gemini

*Where*: Gemini CLI, with any Google account. In the Gemini app, custom MCP servers depend on your plan or workspace; where they are offered, paste the same address.

1. Add Cortex for your user:

   ```sh
   gemini mcp add --transport http --scope user cortex https://app.cortexexam.com/mcp
   ```

2. Start **gemini** and sign in:

   ```
   /mcp auth cortex
   ```

3. A browser window opens: sign in with your Cortex account.

Or in `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "cortex": {
      "httpUrl": "https://app.cortexexam.com/mcp"
    }
  }
}
```

Gemini CLI uses `httpUrl` for Streamable HTTP servers; `url` would mean an SSE server.

### Claude Code

*Where*: Claude Code, in the terminal, the desktop app or your IDE.

1. Add Cortex for all your projects:

   ```sh
   claude mcp add --transport http --scope user cortex https://app.cortexexam.com/mcp
   ```

2. In Claude Code, run `/mcp`, pick **cortex**, then **Authenticate**:

   ```
   /mcp
   ```

3. Sign in with your Cortex account in the browser.

Without `--scope user`, Cortex is added to the current project only. Claude Code shows the cost of a paid tool in a confirmation dialog before anything runs.

### Cursor

*Where*: Cursor, desktop app.

One click: [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cortex&config=eyJ1cmwiOiJodHRwczovL2FwcC5jb3J0ZXhleGFtLmNvbS9tY3AifQ==)

1. Click **Add to Cursor** and confirm in Cursor.
2. When Cursor connects, sign in with your Cortex account. If the page doesn't open, use the sign-in button next to Cortex in Cursor's MCP settings.

Or by hand, in `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "cortex": {
      "url": "https://app.cortexexam.com/mcp"
    }
  }
}
```

### VS Code

*Where*: VS Code with GitHub Copilot Chat, in agent mode.

One click: [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22cortex%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.cortexexam.com%2Fmcp%22%7D)

1. Click **Add to VS Code**, review, then install. Or run **MCP: Add Server** from the Command Palette, choose **HTTP** and paste the address.
2. On first use, VS Code opens a browser window: sign in with your Cortex account.
3. In Copilot Chat, switch to agent mode and ask.

Or in `.mcp.json`, at the root of a project:

```json
{
  "mcpServers": {
    "cortex": {
      "type": "http",
      "url": "https://app.cortexexam.com/mcp"
    }
  }
}
```

### Codex

*Where*: Codex CLI and the Codex IDE extension.

1. In a terminal:

   ```sh
   codex mcp add cortex --url https://app.cortexexam.com/mcp
   ```

2. Sign in:

   ```sh
   codex mcp login cortex
   ```

3. In the IDE extension: gear menu → **MCP servers** → **Add server**, choose **Streamable HTTP**, paste the address, save, then restart the extension.

Or in `~/.codex/config.toml`:

```toml
[mcp_servers.cortex]
url = "https://app.cortexexam.com/mcp"
```

No browser on this machine? Add `--no-browser` to the login command.

### Windsurf

*Where*: Windsurf, in Cascade.

1. Add Cortex to `~/.codeium/windsurf/mcp_config.json`:

   ```json
   {
     "mcpServers": {
       "cortex": {
         "serverUrl": "https://app.cortexexam.com/mcp"
       }
     }
   }
   ```

2. Refresh the MCP servers in Cascade. Windsurf opens the sign-in page: use your Cortex account.

Windsurf uses `serverUrl` for remote servers.

### Other client

*Where*: Any client that supports remote MCP servers over Streamable HTTP with OAuth.

1. Address:

   ```
   https://app.cortexexam.com/mcp
   ```

2. Transport: **Streamable HTTP**. Authentication: **OAuth 2.1**, discovered from the server's protected-resource metadata, with dynamic client registration. No API key, no header.

Typical configuration:

```json
{
  "mcpServers": {
    "cortex": {
      "type": "http",
      "url": "https://app.cortexexam.com/mcp"
    }
  }
}
```

A client that only runs local (stdio) servers? Bridge it:

```sh
npx mcp-remote https://app.cortexexam.com/mcp
```

Server card: [/.well-known/mcp/server-card.json](https://cortexexam.com/.well-known/mcp/server-card.json). Markdown version of this page: [/mcp.md](https://cortexexam.com/mcp.md).

## Tools

Reading is free. Generating uses the same credits as in the app: the assistant first tells you the exact cost, and only runs once you say yes.

| Tool | What it does | Cost |
|---|---|---|
| `list_courses` | Lists your courses, with exam dates and days left. | Free |
| `get_study_plan` | What to revise next, weighted by how often each topic came up in past exams. | Free |
| `get_weak_points` | Your weak points by severity, and which ones are due for review. | Free |
| `get_results` | Your mock exams, practice scores and graded feedback. | Free |
| `search_course_materials` | Searches your slides, notes and past exams, and returns the passage. | Free |
| `get_account_status` | Your credit balance, the cost of each action and today's limits. | Free |
| `get_job_status` | Follows a generation and returns the exam once it's ready. | Free |
| `create_course` | Creates a course: name, code, university, exam date. | Free |
| `set_exam_format` | Declares the real exam format: type, number of questions, duration. | Free |
| `add_course_source` | Adds a document to a course, from a web link or its text. | Free |
| `report_question` | Flags a generated question that is wrong or off the syllabus. | Free |
| `generate_mock_exam` | A full mock exam in your course's real format. A longer exam costs a little more. | 5 credits (written) · 4 credits (multiple choice) |
| `prepare_course` | Reads your materials, learns the exam format and builds the course plan. | 2 credits |
| `generate_drill` | One exam-style question, with hints and a worked solution. | 0.3 credit |
| `check_answer` | Grades your answer the way the examiner would. | 0.3 credit |

Generations also count toward the app's daily limits. [See the plans](https://cortexexam.com/#pricing).

## Security

- **Sign in, no key.** Cortex uses OAuth with your Cortex account. There is no API key to copy, paste or leak, and access tokens expire after an hour and renew on their own.
- **You choose what it may do.** The consent screen spells it out: reading is always included; generating and adding courses are boxes you can untick. Never allowed: deleting your courses or documents, or touching your payments.
- **Your account, nobody else's.** Every call runs in your own account. The account comes from the sign-in, never from what the assistant types: another student's course simply doesn't exist for it.
- **Revoke in one click.** In the app, open Mon compte → Applications connectées and click Révoquer. Access stops at once. The app is in French for now.

Text from your documents and from generated exams is treated as data, never as instructions. Details in the [privacy policy](https://cortexexam.com/privacy-en) and the [terms](https://cortexexam.com/terms-en).

## Questions

### Is the connector free?

Connecting is free, and so is everything that reads your account. Generations use your Cortex credits, at the same cost as in the app, and that cost is announced before anything runs. Your assistant's own subscription is separate.

### Do I need a Cortex account?

Yes: the assistant works on your courses. [Create your account](https://app.cortexexam.com), add a course, then connect your assistant.

### Can it upload my PDFs?

It adds a document to a course from a web link or from its text, which your assistant can read from a PDF you attach. For a whole folder of slides, drop it in the app.

### Does it work on my phone?

In Claude, yes: add Cortex once on claude.ai, then use it from the mobile app. ChatGPT adds custom servers on the web.

### What does my assistant see?

Only what a tool returns: your courses, plan, weak points, results, excerpts of your documents and your credit balance. That conversation is then handled by your assistant's provider, under its own terms. See our [privacy policy](https://cortexexam.com/privacy-en).

## Links

- Cortex: https://cortexexam.com/
- App: https://app.cortexexam.com
- Privacy: https://cortexexam.com/privacy-en
- Terms: https://cortexexam.com/terms-en
- llms.txt: https://cortexexam.com/llms.txt
