mcp-ctftime
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-ctftime show me the top 10 CTF teams for this year"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-ctftime
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-ctftimeOption 2: Global install
npm install -g mcp-ctftime
mcp-ctftimeOption 3: From source
git clone https://github.com/tomek7667/mcp-ctftime.git
cd mcp-ctftime
pnpm install
pnpm build
pnpm startRelated MCP server: CTFd MCP Server
Tools
Tool | Description |
| List events in a UNIX timestamp window |
| Get event details by ID |
| Get top teams (current or specific year) |
| Get top teams by country (current year) |
| Get team details by ID |
| Get event results for a 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.jsonWindows:
%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-ctftimeOr 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.jsonWindows:
%APPDATA%\Code\User\settings.jsonLinux:
~/.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-ctftimeGemini 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-ctftimeUse /mcp in Gemini CLI to verify server status.
Docker
docker build -t mcp-ctftime .
docker run -i mcp-ctftimeFor 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 watchAPI 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 toolsctftime_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
Scored across 7 tools
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.
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.
Seven tools cover the core read operations for CTFtime without being excessive. The number feels well-scoped for a focused data retrieval server.
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
Related MCP Connectors
Real-time CVE, exploit, and vulnerability intelligence for AI assistants (350K+ CVEs, 115K+ PoCs)
ctlogs.dev searches the public Certificate Transparency logs, where every publicly trusted TLS certificate is recorded. Connected to it, an assistant can answer questions such as "which subdomains does example.com have", "who issued the certificates for this name" or "which domains does this company hold certificates for".
Read-only search of 2,189 AI agent tools (MCP servers, x402 APIs) with daily automated trust scores.
Deltabridge brings an AI-native cyber threat intelligence platform into your AI agent. Search a knowledge graph of 400,000+ threat actors, malware families, vulnerabilities, indicators and campaigns, mapped to MITRE ATT&CK. Look up and enrich IOCs, trace links between entities and read living briefs built from 300+ open sources. Read-only, scoped to your organisation, with OAuth sign-in or an API key. Included on Researcher, Business and Enterprise plans.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.121MIT
- AlicenseBqualityDmaintenanceEnables 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.520 PyPI24Apache 2.0
- FlicenseAqualityDmaintenanceProvides 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.94-
- AlicenseNot gradedqualityCmaintenanceEnables users to list CTFd challenges, read details, start/stop dynamic Docker instances, and submit flags through natural language.5Apache 2.0