home / mcp / ctftime mcp server

CTFtime MCP Server

Provides programmatic access to CTFtime.org data via MCP for events, teams, and results.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "0x-professor-ctf-time-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You can run and connect to the CTFtime MCP Server to programmatically access CTF data such as upcoming events, team rankings, event details, and results. This MCP server provides a consistent interface you can use from MCP-enabled clients to automate querying and analysis of CTF data.

How to use

Set up an MCP client and point it at the CTFtime MCP server to perform common tasks. You can retrieve upcoming or past CTF events, fetch detailed information about a specific event, query global or country-specific team rankings, obtain team information, access event results, and search for events. Use the client’s standard MCP methods to request data like upcoming events, event details, top teams, and results, then present or process that data in your workflow.

How to install

Prerequisites: install Python 3.13 or higher and ensure you have a compatible runtime such as uv (recommended) or pip available.

Install from source by cloning the MCP server project, then install dependencies and run the server.

# Clone the MCP server repository
git clone https://github.com/0x-Professor/CTF-time-mcp.git
cd ctf-times-mcp

# Install dependencies (example for Python-based setup)
pip install -e .

# Start the server (Python directly)
python server.py

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

Additional notes and recommended usage

The server exposes data through endpoints and is intended to be used by MCP clients. Typical workflows include listing upcoming CTFs for the next weeks, retrieving details for a specific event, listing top teams globally or by country, and pulling event results for analysis. You can also integrate with clients like Claude Desktop or VS Code Continue by configuring the MCP server as shown in the client setup steps.

Security and best practices

Respect rate limits and avoid excessive querying to prevent overloading the upstream CTFtime API. Implement appropriate request throttling in your MCP client or gateway if you deploy multiple clients. Keep your client and server dependencies up to date and monitor for API changes from CTFtime.org.

Examples of common tasks

- 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.

- Display the CTF calendar for March 2026.

Available tools

get_upcoming_ctfs

Retrieve upcoming CTF events with 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 monthly calendar of CTF events