CTF-time-mcp: MCP Tool for Accessing CTFtime.org Data and Getting Event Info & Results

Ctf Time MCP

An MCP server that provides access to CTFtime.org data, allowing you to obtain CTF competition information, team rankings, event details, and competition results

Security Education and learning tools #CTF Competitions #Cybersecurity #Event Data #Team Rankings .Python

rating : 2.5 points

downloads : 4.6K

update time : 2026-03-12

Open Site

What is the CTFtime MCP Server?

The CTFtime MCP server is a bridge connecting AI assistants (such as Claude) with the CTFtime.org platform. CTFtime is the world's largest information platform for cybersecurity competitions (CTF). Through this server, you can directly ask the AI assistant for CTF competition information, as simple as asking a normal question. Main functions include: • Query upcoming CTF competitions • View historical competition results • Obtain global CTF team rankings • Search for specific competition details • Analyze team performance data

How to Use the CTFtime MCP Server?

The usage process is very simple: 1. Configure the server in an AI client that supports MCP (such as Claude Desktop) 2. After successful connection, directly ask the AI a question 3. The AI will automatically call CTFtime data to provide you with an answer For example, you can ask: "What CTF competitions are there in the next two weeks?" or "Show the top 10 CTF teams in Germany." The AI will understand your intention and return structured information.

Applicable Scenarios

This server is particularly suitable for the following users: • CTF participants: Plan competition schedules and understand the strength of opponents • Cybersecurity learners: Find competitions suitable for their own level • Team managers: Analyze team performance and formulate training plans • Event organizers: Understand industry trends and competition trends • Cybersecurity enthusiasts: Follow CTF event news and results

Main Functions

Competition Query

Query upcoming and completed CTF competitions, supporting filtering by time range. You can obtain detailed information such as competition names, times, locations, and organizers.

Team Ranking

View global CTF team rankings, supporting filtering by country/region. Understand the strength and performance trends of top teams.

Event Details

Obtain complete information about specific competitions, including competition forms, difficulty levels, challenge categories, participation requirements, etc.

Intelligent Search

Search for CTF competitions by keywords, supporting multi - dimensional search by name, description, organizer, etc., to quickly find competitions of interest.

Calendar View

View CTF competition schedules in calendar form, intuitively understand the monthly competition distribution, and facilitate planning of participation time.

Result Analysis

View competition results and scoring situations, analyze team performance, and understand the intensity of competition.

Advantages

No programming required: Query CTF data through natural language without learning API calls

Real - time data: Connect directly to the CTFtime official API to obtain the latest competition information

Multi - dimensional query: Support multiple filtering conditions such as time, region, difficulty, and category

AI enhancement: Combine the understanding ability of AI to provide intelligent data analysis and interpretation

Easy to integrate: Support mainstream AI clients, with simple and fast configuration

Limitations

Network - dependent: Requires a stable network connection to access the CTFtime API

Data delay: There may be a slight delay in the update of competition results

Function limitation: Only provide public data on the CTFtime platform

Client requirement: Requires an AI client that supports the MCP protocol

Rate limitation: Subject to the CTFtime API call frequency limit

How to Use

Installation Preparation

Ensure that your system has Python 3.13 or a higher version installed. It is recommended to use the uv package manager, but you can also use pip.

Download the Server

Download the CTFtime MCP server code from the GitHub repository.

Install Dependencies

Install all the dependency packages required for the server to run.

Configure the AI Client

Add the server to the AI client you are using. Here is a configuration example for Claude Desktop.

Start Using

Restart the AI client. After successful connection, you can start querying CTF information.

Usage Examples

Plan Participation Schedule

As a CTF participant, you need to plan your competition schedule for the next month and find out which competitions are suitable to participate in.

Team Strength Analysis

As a team captain, you want to understand the strength of your competitors and formulate a training plan.

Find Learning Resources

As a beginner in cybersecurity, you want to improve your skills through CTF competitions but don't know where to start.

Event Research

As an event organizer, you want to understand the current trends and popular themes of CTF competitions.

Frequently Asked Questions

Do I need programming knowledge to use this server?

Is the data real - time?

Which AI clients are supported?

Is there a limit on the number of queries?

How can I get the ID of a specific competition?

Is the server charged?

Related Resources

CTFtime Official Website

The world's CTF competition information platform, providing competition calendars, team rankings, competition results, etc.

GitHub Repository

Server source code and the latest version

MCP Official Documentation

Model Context Protocol technical specifications and documentation

CTF Learning Resources

CTF getting - started guide and basic knowledge

Python MCP SDK

Python toolkit required for developing MCP servers

🚀 CTFtime MCP Server

A Model Context Protocol (MCP) server that offers programmatic access to CTFtime.org data. Retrieve details about CTF competitions, team rankings, event information, and competition results via a standardized interface.

✨ Features

Tools

Tool	Description
`get_upcoming_ctfs`	Retrieve upcoming CTF events with a configurable time range
`get_past_ctfs`	Retrieve historical CTF events
`get_event_details`	Get comprehensive information about a specific event
`get_top_teams`	Query global CTF team rankings
`get_top_teams_by_country`	Query regional team rankings by country code
`get_team_info`	Retrieve detailed team information and statistics
`get_event_results`	Access competition results and scores
`search_events`	Search events by name, description, or organizer
`get_ctf_calendar`	View the monthly calendar of CTF events

Prompts

Prompt	Description
`analyze_ctf_event`	Generate an analysis for a specific CTF event
`find_beginner_ctfs`	Identify beginner-friendly competitions
`team_performance_analysis`	Analyze team performance metrics
`weekly_ctf_briefing`	Generate a weekly competition summary
`country_ctf_scene`	Analyze the regional CTF community

Resources

Resource URI	Description
`ctftime://info`	Server and platform documentation
`ctftime://formats`	CTF competition format reference
`ctftime://categories`	Challenge category documentation

📦 Installation

Prerequisites

Python 3.13 or higher
uv (recommended) or pip

Using uv (Recommended)

git clone https://github.com/0x-Professor/CTF-time-mcp.git
cd ctf-times-mcp
uv sync

Using pip

git clone https://github.com/yourusername/ctf-times-mcp.git
cd ctf-times-mcp
pip install -e .

💻 Usage Examples

Running the Server

# Using uv
uv run server.py

# Using Python directly
python server.py

Development Mode

# Launch with MCP Inspector for testing
uv run mcp dev server.py

📚 Documentation

Client Configuration

To add the CTFtime MCP server to Claude Desktop, run this command:

uv run mcp install server.py --name "CTFtime"

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ctftime": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ctf-times-mcp", "server.py"]
    }
  }
}

VS Code with Continue

Add to your Continue configuration:

{
  "mcpServers": [
    {
      "name": "ctftime",
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "/path/to/ctf-times-mcp"
    }
  ]
}

Example Queries

Once connected to an MCP-compatible client:

"List upcoming CTF competitions for the next two weeks"
"Get details for CTF event ID 2345"
"Show the top 20 CTF teams globally"
"Find CTF teams from Germany"
"Search for CTF events related to DEF CON"
"Display the CTF calendar for March 2026"

API Reference

This server interfaces with the CTFtime.org API.

Endpoints Used

Endpoint	Purpose
`/api/v1/events/`	Event listing with date filters
`/api/v1/events/{id}/`	Individual event details
`/api/v1/top/`	Global team rankings
`/api/v1/top/{year}/`	Year-specific rankings
`/api/v1/top-by-country/{code}/`	Country-specific rankings
`/api/v1/teams/{id}/`	Team information
`/api/v1/results/`	Competition results

Rate Limiting

The CTFtime.org API is provided for data analysis and application development. Implement appropriate request throttling to respect server resources.

Competition Formats

Format	Description	Skill Level
Jeopardy	Category-based challenges (Web, Crypto, Pwn, Rev, Forensics)	All levels
Attack-Defense	Real-time offensive and defensive operations	Advanced
Mixed	Combination of Jeopardy and Attack-Defense	Intermediate+
Hack Quest	Narrative-driven progressive challenges	Learning

Challenge Categories

Category	Focus Area
Web	Web application security vulnerabilities
Crypto	Cryptographic analysis and exploitation
Pwn	Binary exploitation and memory corruption
Reverse	Static and dynamic binary analysis
Forensics	Digital artifact investigation
OSINT	Open source intelligence gathering
Misc	Programming, trivia, unconventional challenges

Project Structure

ctf-times-mcp/
├── server.py          # MCP server implementation
├── pyproject.toml     # Project configuration and dependencies
└── README.md          # Documentation

Development

Testing

# Run with MCP Inspector
uv run mcp dev server.py

# Execute tests
uv run pytest

Code Style

This project follows PEP 8 conventions with type annotations throughout.

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/enhancement)
Commit changes (git commit -m 'Add enhancement')
Push to the branch (git push origin feature/enhancement)
Open a Pull Request

📄 License

This project is licensed under the MIT License. See LICENSE for details.

Acknowledgments

CTFtime.org - Competition tracking platform and API
Model Context Protocol - Protocol specification
MCP Python SDK - Server implementation framework

Disclaimer

This is an independent project and is not affiliated with or endorsed by CTFtime.org. Please review and comply with CTFtime.org's terms of service and API usage guidelines.