# Proctor MCP server

> Runs Proctor exams against MCP servers, streams results, and manages Fly.io machines used for exam execution.

- Repository: https://github.com/pulsemcp/mcp-servers
- Page: https://hostedmcp.org/servers/pulsemcp/proctor
- Official: yes
- Transport: stdio
- Stars: 81
- License: MIT
- Latest version: 0.1.9

## Install

### Claude Code

```sh
claude mcp add --env 'PROCTOR_API_KEY=<YOUR_PROCTOR_API_KEY>' proctor -- npx -y proctor-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "proctor": {
      "command": "npx",
      "args": [
        "-y",
        "proctor-mcp-server"
      ],
      "env": {
        "PROCTOR_API_KEY": "<YOUR_PROCTOR_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "proctor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "proctor-mcp-server"
      ],
      "env": {
        "PROCTOR_API_KEY": "<YOUR_PROCTOR_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"proctor","type":"stdio","command":"npx","args":["-y","proctor-mcp-server"],"env":{"PROCTOR_API_KEY":"<YOUR_PROCTOR_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "proctor": {
      "command": "npx",
      "args": [
        "-y",
        "proctor-mcp-server"
      ],
      "env": {
        "PROCTOR_API_KEY": "<YOUR_PROCTOR_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add proctor --env 'PROCTOR_API_KEY=<YOUR_PROCTOR_API_KEY>' -- npx -y proctor-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.proctor]
command = "npx"
args = ["-y", "proctor-mcp-server"]

[mcp_servers.proctor.env]
PROCTOR_API_KEY = "<YOUR_PROCTOR_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'PROCTOR_API_KEY=<YOUR_PROCTOR_API_KEY>' proctor npx -- -y proctor-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "proctor": {
      "command": "npx",
      "args": [
        "-y",
        "proctor-mcp-server"
      ],
      "env": {
        "PROCTOR_API_KEY": "<YOUR_PROCTOR_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PROCTOR_API_KEY` | yes | yes | API key for PulseMCP Proctor API authentication. |
| `PROCTOR_API_URL` | no | no | Base URL for Proctor API. |
| `TOOL_GROUPS` | no | no | Comma-separated list of enabled tool groups. |

## Tools (4)

- `exams`
- `exams_readonly`
- `machines`
- `machines_readonly`

## FAQ

### How do I authenticate the Proctor MCP server?

You provide a Proctor API key via the PROCTOR_API_KEY environment variable, which is required and not publicly available.

### What tools can run exams against an MCP server?

The exams tool group provides get_proctor_metadata to list runtimes and exams and run_exam to execute an exam with streaming logs.

### Can I limit the server to read-only tools?

Yes, each tool group has a readonly variant such as exams_readonly or machines_readonly, set through TOOL_GROUPS.

### How do I clean up exam infrastructure?

Use get_machines to list active Fly.io machines, cancel_exam to stop a running exam, and destroy_machine to delete a machine.

### What environment variable controls which tools are enabled?

TOOL_GROUPS takes a comma-separated list of tool groups and defaults to exams,machines (all groups).
