codeforces-mcp

Mohamed-hanfy/codeforces-mcp

3.4

If you are the rightful owner of codeforces-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server that provides seamless access to the Codeforces API.

The Codeforces MCP Server is designed to facilitate interaction with the Codeforces platform through a standardized Model Context Protocol interface. This server enables users to access a wide range of functionalities related to Codeforces contests, user data, submissions, and ratings. By leveraging the Codeforces API, the server offers a streamlined and efficient way to retrieve and manage data, making it an invaluable tool for developers and competitive programming enthusiasts. The server is built with asynchronous support using async/await, ensuring optimal performance and responsiveness. It is containerized using Docker, allowing for easy deployment and scalability. The server's architecture is designed to be robust and flexible, accommodating various use cases and integration scenarios.

Features

  • Contest Management: Access contest lists, standings, and rating changes.
  • User Information: Retrieve user profiles, rating history, and submissions.
  • Submission Tracking: Monitor recent submissions and contest-specific submissions.
  • Rating Data: Obtain user rating changes and lists of rated users.
  • Async Support: Built with async/await for enhanced performance.

Usages

docker usage

bash
docker pull mohamed2x/codeforces-mcp
docker run -i --rm mohamed2x/codeforces-mcp:latest

local stdio usage

python
mcp.run(transport='stdio')  # Connects to Codeforces API

Tools

  1. get_contest_list

    Get list of contests (with optional gym and group filters)

  2. get_contest_rating_changes

    Get rating changes after a specific contest

  3. get_contest_standings

    Get contest standings with customizable filters

  4. get_contest_status

    Get submissions for a specific contest

  5. get_user_info

    Get detailed user information

  6. get_user_rating

    Get user's complete rating history

  7. get_user_submissions

    Get user's submission history

  8. get_rated_users

    Get list of all rated users

  9. get_recent_submissions

    Get recent submissions across the platform