Codeforces MCP Server
A Model Context Protocol (MCP) server that provides seamless access to the Codeforces API. This server allows you to interact with Codeforces contests, user data, submissions, and ratings through a standardized MCP interface.
Features
- Contest Management: Get contest lists, standings, and rating changes
- User Information: Retrieve user profiles, rating history, and submissions
- Submission Tracking: Access recent submissions and contest-specific submissions
- Rating Data: Get user rating changes and rated user lists
- Async Support: Built with async/await for optimal performance
Available Tools
Contest Tools
get_contest_list- Get list of contests (with optional gym and group filters)get_contest_rating_changes- Get rating changes after a specific contestget_contest_standings- Get contest standings with customizable filtersget_contest_status- Get submissions for a specific contest
User Tools
get_user_info- Get detailed user informationget_user_rating- Get user's complete rating historyget_user_submissions- Get user's submission historyget_rated_users- Get list of all rated users
General Tools
get_recent_submissions- Get recent submissions across the platform
Project Structure
.
├── Dockerfile # Docker container configuration
├── LICENSE
├── README.md
└── src/
├── codeforces_mcp.py # Main MCP server implementation with Codeforces API integration.
└── requirements.txt # Python dependencies.
Installation
Docker (Recommended)
- Pull the image from Docker Hub:
docker pull mohamed2x/codeforces-mcp
- Run the container:
docker run -i --rm mohamed2x/codeforces-mcp:latest
Configuration
The server runs on stdio transport by default and connects to the official Codeforces API at https://codeforces.com/api.
Dependencies
fastmcp- MCP server frameworkhttpx- Async HTTP clienturllib.parse- URL parameter encoding
Metadata
Release files for iflow-mcp_mohamed-hanfy_codeforces-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1.tar.gz | 3.0 kB | Without provenance | Details for iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1-py3-none-any.whl |
Total release size: 6.4 kB
Release files / iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1.tar.gz
| Download URL | iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1.tar.gz |
|---|---|
| Size | 3.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f32dbccd306c214397ff04add466747dec9e9493e80c8c1e6794a5de5f242a16
|
|
BLAKE2b-256 checksum How to use checksums |
1d92caeaad15ce406bef5ba0409425d9af3037c7d6b8b9fa591b87410b642ce1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1-py3-none-any.whl
| Download URL | iflow_mcp_mohamed_hanfy_codeforces_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 3.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
baf85d006eb5e03df6a97817976c03d1bec4ba2b737c68b08da171d8331a3e1a
|
|
BLAKE2b-256 checksum How to use checksums |
662f62fc18d6f6433673aa9d30f722da68bca0bb988c97eea573e9fd058aa44f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_mohamed-hanfy_codeforces-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.