Click on "Install 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., "@CTFtime MCP ServerShow me upcoming CTF competitions for the next two weeks"
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.
CTFtime MCP Server
A Model Context Protocol (MCP) server providing programmatic access to CTFtime.org data. Retrieve information about CTF competitions, team rankings, event details, and competition results through a standardized interface.
Features
Tools
Tool | Description |
| Retrieve upcoming CTF events with configurable time range |
| Retrieve historical CTF events |
| Get comprehensive information about a specific event |
| Query global CTF team rankings |
| Query regional team rankings by country code |
| Retrieve detailed team information and statistics |
| Access competition results and scores |
| Search events by name, description, or organizer |
| View monthly calendar of CTF events |
Prompts
Prompt | Description |
| Generate analysis for a specific CTF event |
| Identify beginner-friendly competitions |
| Analyze team performance metrics |
| Generate weekly competition summary |
| Analyze regional CTF community |
Resources
Resource URI | Description |
| Server and platform documentation |
| CTF competition format reference |
| Challenge category documentation |
Installation
Prerequisites
Python 3.13 or higher
uv (recommended) or pip
Using uv (Recommended)
Using pip
Usage
Running the Server
Development Mode
Client Configuration
To add the CTFtime MCP server to Claude Desktop, run this command:
Claude Desktop
Add the following to your claude_desktop_config.json:
VS Code with Continue
Add to your Continue configuration:
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 |
| Event listing with date filters |
| Individual event details |
| Global team rankings |
| Year-specific rankings |
| Country-specific rankings |
| Team information |
| 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
Development
Testing
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 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.