CTFd MCP Server

A Model Context Protocol (MCP) server for interacting with any CTFd v3 instance. It lets AI tools (Claude Desktop, Cursor, custom agents, ...) authenticate, list and inspect challenges, submit…

Local serverstdio

What is the CTFd MCP Server?

ctfd-mcp-server is an MCP project maintained in the mrjamescot/ctfd-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for interacting with any CTFd v3 instance. It lets AI tools (Claude Desktop, Cursor, custom agents, ...) authenticate, list…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using ctfd-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares CTFD_BASE_URL, CTFD_ADMIN_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
set_base_url	url
set_token	token
set_cookie	cookie
login	username, password
challenges	category, search, solved, page, per_page
challenge	identifier (id or name)
submit_flag	flag, challenge_name/challenge_id, confirm
download_file	file_url, dest_dir
unlock_hint	hint_id
scoreboard	—
progress	—
instance_info	—
auth_status	—
health	—

How to install the CTFd MCP Server

{
  "mcpServers": {
    "ctfd-mcp": {
      "command": "ctfd-mcp",
      "env": {
        "CTFD_BASE_URL": "https://demo.ctfd.io",
        "CTFD_ADMIN_TOKEN": "YOUR_CTFD_ADMIN_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
CTFD_BASE_URL	Declared in the maintainer’s client configuration.	Check documentation
CTFD_ADMIN_TOKEN	Declared in the maintainer’s client configuration.	Check documentation