Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

CTFd

PYPI · CTFD-MCP-SERVER · SCANNED SEP 21

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

Available components

66 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs setuptools.build_meta at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
  • 1 of 45 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
Schema Quality & AI Usability80
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 846 tokens (~60/item across 14 items; 14 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage71
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 0% of tool parameters carry a description.Fail
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 14 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

How do I install the CTFd MCP server?

CTFd runs locally as a PyPI package, launched with uvx ctfd-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · ctfd-mcp-server

# add to Claude Code
claude mcp add mrjamescot-ctfd-mcp-server -- uvx ctfd-mcp-server
// .cursor/mcp.json
{
  "mcpServers": {
    "mrjamescot-ctfd-mcp-server": {
      "command": "uvx",
      "args": [
        "ctfd-mcp-server"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "mrjamescot-ctfd-mcp-server": {
      "command": "uvx",
      "args": [
        "ctfd-mcp-server"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add mrjamescot-ctfd-mcp-server -- uvx ctfd-mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mrjamescot-ctfd-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "ctfd-mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add mrjamescot-ctfd-mcp-server --command uvx --arg ctfd-mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  mrjamescot-ctfd-mcp-server:
    command: "uvx"
    args: ["ctfd-mcp-server"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "mrjamescot-ctfd-mcp-server": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "ctfd-mcp-server"
      ]
    }
  }
}
# add to Vellum
assistant mcp add mrjamescot-ctfd-mcp-server -t stdio -c uvx -a ctfd-mcp-server
// mcp.json
{
  "mcpServers": {
    "mrjamescot-ctfd-mcp-server": {
      "command": "uvx",
      "args": [
        "ctfd-mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Sept 26 +30
    • Injection markers: unverified → pass security
    • First check of Judged manipulation: pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool safety: Tool safety not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. security
    • Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
    • Tool coverage: unverified → 100 functional
    • MCP protocol: unverified → pass functional
    • First check of Tool coverage: 0 functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: excellent functional
    • First check of Destructive annotations: pass functional
    • First check of Schema quality: pass functional
    • First check of Tool coverage: 100 functional
    • Capabilities: Protocol version not yet verified: we do not have a sandbox capture of the MCP handshake this version of the package performs yet. functional
    • Tool coverage: Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. functional
    • Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
    • Package version: 1.0.3 → 1.0.4 functional
  • 20 Sept 26 36

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Sept 2026 · Analysed pypi/ctfd-mcp-server@1.0.4

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted setuptools.build_meta

Background: Why install scripts are a supply-chain risk →

Dependencies 45 packages
Packages resolved 45
Stale 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 14 exposed · ~846 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
auth_status ~32

Report whether the current session is authenticated and which auth mode is active. Reveals no tokens/cookies/passwords.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes

No examples provided.

challenge ~60

Get the full detail of a single challenge by numeric id or name. Includes description, category, value, files, hints and connection info. Args: identifier: challenge id (e.g. "3") or challenge name.

NameTypeReqDescription
identifierstringyes
NameTypeReqDescription
resultstringyes

No examples provided.

challenges ~116

List challenges with optional filters and pagination. Args: category: filter by challenge category (exact match). search: case-insensitive substring match on challenge name. solved: only show solved (True) or unsolved (False) challenges. page: page number (1-based) when no filters are applied. per_page: number of challenges per page (1-100).

NameTypeReqDescription
category
pageinteger
per_pageinteger
search
solved
NameTypeReqDescription
resultstringyes

No examples provided.

download_file ~121

Download a challenge attachment to the local machine. Challenge detail (``challenge`` tool) returns a ``files`` array with site-relative paths like ``/files/<hash>/<name>`` (signed URLs on some deployments). Pass one of those values here. Args: file_url: absolute http(s) URL or site-relative path to the file. dest_dir: optional local directory to store the file in (default: CTFD_DOWNLOAD_DIR or ./downloads).

NameTypeReqDescription
dest_dir
file_urlstringyes
NameTypeReqDescription
resultstringyes

No examples provided.

health ~24

Perform a health check: CTFd reachability, API status and authentication state.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes

No examples provided.

instance_info ~26

Return safe, public metadata about the configured CTFd instance. No secrets are included.

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes

No examples provided.

login ~70

Log in to CTFd with a username and password (kept in memory only). Creates a session cookie; the password is never returned. Args: username: CTFd account name. password: CTFd account password.

NameTypeReqDescription
passwordstringyes
usernamestringyes
NameTypeReqDescription
resultstringyes

No examples provided.

progress ~18

Return the authenticated user's progress (score and solved challenges).

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes

No examples provided.

scoreboard ~18

Return the public CTFd scoreboard (top standings).

Input schema present but exposes no named parameters.

NameTypeReqDescription
resultstringyes

No examples provided.

set_base_url ~54

Configure the CTFd instance this server talks to. Args: url: absolute http(s) URL of the CTFd instance, e.g. https://ctf.example.com

NameTypeReqDescription
urlstringyes
NameTypeReqDescription
resultstringyes

No examples provided.

set_cookie ~56

Use a session cookie for authentication (memory only, never logged). Args: cookie: full session cookie value, e.g. "session=abc..." or "name=..; session=..".

NameTypeReqDescription
cookiestringyes
NameTypeReqDescription
resultstringyes

No examples provided.

set_token ~42

Use an API token for authentication (stored in memory only, never logged). Args: token: CTFd API access token.

NameTypeReqDescription
tokenstringyes
NameTypeReqDescription
resultstringyes

No examples provided.

submit_flag ~115

Submit a flag for a challenge. Safety: requires confirm=True. Provide exactly one of challenge_id or challenge_name. The flag value is never logged. Args: flag: the flag to submit. challenge_name: name of the challenge to submit against. challenge_id: numeric id of the challenge to submit against. confirm: must be set to True as an explicit submission opt-in.

NameTypeReqDescription
challenge_id
challenge_name
confirmboolean
flagstringyes
NameTypeReqDescription
resultstringyes

No examples provided.

unlock_hint ~94

Unlock a challenge hint and return its content. WARNING: on CTFd a hint with a non-zero ``cost`` deducts that many points from your account. When two hint IDs are needed (e.g. a hint's prerequisites), unlock them in order. Args: hint_id: numeric id of the hint (see the ``challenge`` tool result).

NameTypeReqDescription
hint_idintegeryes
NameTypeReqDescription
resultstringyes

No examples provided.

Common questions

What is the CTFd MCP server?

CTFd is an MCP server listed in the public MCP registry as io.github.MrJamescot/ctfd-mcp-server. MCP server for CTFd v3: list challenges, submit flags, and query scoreboards via AI agents. This page covers its PyPI package (ctfd-mcp-server).

Is the CTFd MCP server safe to use?

CTFd scores 66 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the CTFd MCP server expose?

CTFd exposes 14 tools: set_base_url, set_token, set_cookie, login, challenges, and 9 more. Their descriptions and schemas cost roughly 846 tokens of context every time the server is loaded.

Is the CTFd MCP server still maintained?

CTFd is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.