Skip to main content
Glama
mcp-ctftime

mcp-ctftime

by tomek7667

mcp-ctftime

npm version License: MIT

An MCP (Model Context Protocol) server that wraps the public CTFtime API, enabling AI assistants to query CTF events, teams, rankings, and results.

Quickstart

Option 1: npx (no install)

npx mcp-ctftime

Option 2: Global install

npm install -g mcp-ctftime
mcp-ctftime

Option 3: From source

git clone https://github.com/tomek7667/mcp-ctftime.git
cd mcp-ctftime
pnpm install
pnpm build
pnpm start

Related MCP server: CTFd MCP Server

Tools

Tool

Description

ctftime_events(limit?, start?, finish?)

List events in a UNIX timestamp window

ctftime_event(event_id)

Get event details by ID

ctftime_top_teams(year?, limit?)

Get top teams (current or specific year)

ctftime_top_by_country(country_code)

Get top teams by country (current year)

ctftime_team(team_id)

Get team details by ID

ctftime_results(year?)

Get event results for a year

ctftime_votes(year)

Get event votes for a year


Client Setup

Claude Desktop

Claude Desktop supports MCP servers via a JSON configuration file.

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (recommended):

{
	"mcpServers": {
		"ctftime": {
			"command": "npx",
			"args": ["-y", "mcp-ctftime"]
		}
	}
}

Using global install:

{
	"mcpServers": {
		"ctftime": {
			"command": "mcp-ctftime"
		}
	}
}

Restart Claude Desktop after editing the config.


OpenAI Codex CLI

Codex CLI stores MCP configuration in ~/.codex/config.toml.

Using the CLI:

codex mcp add ctftime -- npx -y mcp-ctftime

Or edit ~/.codex/config.toml directly:

[mcp_servers.ctftime]
command = "npx"
args = ["-y", "mcp-ctftime"]

Using global install:

[mcp_servers.ctftime]
command = "mcp-ctftime"

Use /mcp in the Codex TUI to verify the server is connected.


Amp

Amp supports MCP servers via the amp.mcpServers setting in VS Code settings.json or via CLI.

Config file location (VS Code):

  • macOS: ~/Library/Application Support/Code/User/settings.json

  • Windows: %APPDATA%\Code\User\settings.json

  • Linux: ~/.config/Code/User/settings.json

Using npx (recommended):

{
	"amp.mcpServers": {
		"ctftime": {
			"command": "npx",
			"args": ["-y", "mcp-ctftime"]
		}
	}
}

Using global install:

{
	"amp.mcpServers": {
		"ctftime": {
			"command": "mcp-ctftime"
		}
	}
}

Via CLI:

amp mcp add ctftime npx -y mcp-ctftime

Gemini CLI

Gemini CLI stores MCP configuration in ~/.gemini/settings.json.

Using npx (recommended):

{
	"mcpServers": {
		"ctftime": {
			"command": "npx",
			"args": ["-y", "mcp-ctftime"]
		}
	}
}

Using global install:

{
	"mcpServers": {
		"ctftime": {
			"command": "mcp-ctftime"
		}
	}
}

Via CLI:

gemini mcp add ctftime npx -- -y mcp-ctftime

Use /mcp in Gemini CLI to verify server status.


Docker

docker build -t mcp-ctftime .
docker run -i mcp-ctftime

For clients that support Docker-based MCP servers:

{
	"mcpServers": {
		"ctftime": {
			"command": "docker",
			"args": ["run", "-i", "--rm", "mcp-ctftime"]
		}
	}
}

Compatibility

Feature

Supported

Transport

stdio

Node.js

>=18.0.0

Platforms

macOS, Linux, Windows

Tested Clients

Client

Status

Claude Desktop

✅ Verified

OpenAI Codex CLI

✅ Verified

Amp

✅ Verified

Gemini CLI

✅ Verified


Environment Variables

Currently, this server does not require any environment variables. The CTFtime API is public and does not require authentication.


Development

# Clone and install
git clone https://github.com/tomek7667/mcp-ctftime.git
cd mcp-ctftime
pnpm install

# Build
pnpm build

# Run
pnpm start

# Watch mode (auto-rebuild)
pnpm watch

API Reference

This server wraps the public CTFtime API: https://ctftime.org/api/

All timestamps use UNIX epoch seconds. Country codes use ISO 3166-1 alpha-2 format (lowercase, e.g., us, de, pl).

Available Tools

7 tools
ctftime_eventA

Get full details for a specific CTFtime event by event_id.

Inputs: event_id (required).

ctftime_eventsA

List CTFtime events in a time window. Uses UNIX timestamps (seconds) for start/finish; returns past and upcoming events.

Inputs: limit, start, finish.

ctftime_resultsA

Get event results for a year (or current year if omitted).

Inputs: year.

ctftime_teamA

Get information about a specific team by team_id.

Inputs: team_id (required).

ctftime_top_by_countryA

Get top teams for the current year by country (ISO 3166-1 alpha-2 country code, lowercase).

Inputs: country_code (required).

ctftime_top_teamsB

Get top teams for a year (or current year if year omitted).

Inputs: year, limit.

ctftime_votesB

Get event votes for a year.

Inputs: year (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct CTFtime resource: event details, event listing, results, team info, top teams (overall and by country), and votes. No overlapping functionality.

    Naming Consistency4/5

    All tools follow the 'ctftime_' prefix with underscore-separated lowercase names. While verbs are not uniform (e.g., 'event' vs 'events', 'top_by_country'), the pattern is predictable and consistent.

    Tool Count5/5

    Seven tools cover the core read operations for CTFtime without being excessive. The number feels well-scoped for a focused data retrieval server.

    Completeness4/5

    The tool set covers essential queries: single event, list events, results, team info, top teams, and votes. Minor gaps like search or filtering by year in some tools are not critical.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to access World Cube Association speedcubing data including world records, competitor profiles, competition information, and championship results. Supports queries about rankings, competition schedules, and detailed speedcubing statistics through natural language.
      12
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables interaction with CTFd platforms for Capture The Flag competitions, allowing users to list challenges, read details, manage dynamic Docker containers, and submit flags through natural language.
      5
      20 PyPI
      24
      Apache 2.0
    • F
      license
      A
      quality
      D
      maintenance
      Provides programmatic access to CTFtime.org data for retrieving information about CTF competitions, team rankings, and event results. It enables users to search for upcoming events, analyze team performance, and access historical competition data through a standardized interface.
      9
      4
      -