Skip to main content

A complete Codeforces MCP toolset for AI agents

Project description

cf-mcp-orange 🚀

PyPI version

A complete, all-in-one MCP (Model Context Protocol) server for Codeforces. Designed to supercharge AI coding assistants like Cline and Claude Desktop.


✨ Features (9 Powerful Tools)

  1. get_user – Fetch a detailed profile (rating, max rating, last 5 contests, problem stats by difficulty, top 10 categories).
  2. compare_user – Side-by-side comparison of two Codeforces users.
  3. get_problemlist – Search the entire problemset by rating range, topic tags (AND/OR), and sorting.
  4. get_problem – Retrieve the full problem statement, rating, and tags for any specific contest/problem ID.
  5. get_practiceproblems – Identify a user's weakest core topics and recommend 3 targeted problems within +300 rating.
  6. get_random_practice – A completely random problem within +/- 300 of a user's current rating.
  7. get_upsolve – Analyzes a user's last 10 contests and recommends unsolved problems within their rating range.
  8. get_status – Summarizes the last 1000 submissions (AC/WA/TLE counts) and the 20 most recent attempts.

📦 Changelog

v1.0.6 (2026-07-04)

  • 🐛 Fixed: ModuleNotFoundError when running the server — changed absolute import to relative import in get_problem.py
  • Verified: All 8 tools tested and working (get_user, compare_user, get_problemlist, get_problem, get_practiceproblems, get_random_practice, get_upsolve, get_status)

🛠️ Installation & Configuration (No Keys Required!)

You don't need to clone or manually install anything! Just add this to your cline_mcp_settings.json or mcp.json:

{
  "mcpServers": {
    "cf-mcp-orange": {
      "command": "uvx",
      "args": ["cf-mcp-orange"]
    }
  }
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cf_mcp_orange-1.0.6.tar.gz (11.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cf_mcp_orange-1.0.6-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file cf_mcp_orange-1.0.6.tar.gz.

File metadata

  • Download URL: cf_mcp_orange-1.0.6.tar.gz
  • Upload date:
  • Size: 11.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.9

File hashes

Hashes for cf_mcp_orange-1.0.6.tar.gz
Algorithm Hash digest
SHA256 084bb098413bae914cb6d00780f08cb77d6e02d06e6e10d57009520d69d2806e
MD5 7f605513e214332c86537cd722d4fa73
BLAKE2b-256 600d7796c1b4b50bda6fa2b3fa151551b78ddbad1b957b9ba33bec8c7980b944

See more details on using hashes here.

File details

Details for the file cf_mcp_orange-1.0.6-py3-none-any.whl.

File metadata

  • Download URL: cf_mcp_orange-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 16.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.9

File hashes

Hashes for cf_mcp_orange-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 ce25d1ab6e0681e18e0280d0606ff28731c1c63057604bdaaca68af91a18a4e5
MD5 bbe7a396c326f7294a232f44d7745a4e
BLAKE2b-256 7b7b4c0fdcff9d62da9c0a03ea9ba09ca114050b44d64213fa4816c57d301afe

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page