CTFd MCP Server

io.github.MrJamescot/ctfd-mcp-server

Repository Registry

What is the CTFd MCP server?

MCP server for CTFd v3: list challenges, submit flags, and query scoreboards via AI agents.

How to install CTFd

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CTFD_BASE_URL
required
Root URL of the CTFd v3 instance, e.g. https://ctf.example.com (without /api/v1)
CTFD_ADMIN_TOKEN
secret
CTFd API access token (preferred authentication method)
CTFD_SESSION_COOKIE
secret
Full CTFd session cookie, e.g. session=abc...
CTFD_USERNAME
Username for CTFd form login
CTFD_PASSWORD
secret
Password for CTFd form login
CTFD_HTTP_TIMEOUT
Per-request HTTP timeout in seconds (default 15)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ctfd-mcp-server": {
      "command": "uvx",
      "args": [
        "ctfd-mcp-server"
      ],
      "env": {
        "CTFD_BASE_URL": "<YOUR_CTFD_BASE_URL>",
        "CTFD_ADMIN_TOKEN": "<YOUR_CTFD_ADMIN_TOKEN>",
        "CTFD_SESSION_COOKIE": "<YOUR_CTFD_SESSION_COOKIE>",
        "CTFD_USERNAME": "<YOUR_CTFD_USERNAME>",
        "CTFD_PASSWORD": "<YOUR_CTFD_PASSWORD>",
        "CTFD_HTTP_TIMEOUT": "<YOUR_CTFD_HTTP_TIMEOUT>"
      }
    }
  }
}