Metadata-Version: 2.4
Name: cf-mcp-orange
Version: 1.0.3
Summary: A complete Codeforces MCP toolset for AI agents
Author-email: supriya <supriya81205@gmail.com>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=0.1.2
Requires-Dist: httpx>=0.27.0
Requires-Dist: beautifulsoup4>=4.12.0

# cpmcp-oren 🚀

[![PyPI version](https://img.shields.io/pypi/v/cpmcp-oren)](https://pypi.org/project/cpmcp-oren/)

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

---

## ✨ Features (10 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.
.


---

## 🛠️ 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`:

```json
{
  "mcpServers": {
    "cpmcp-oren": {
      "command": "uvx",
      "args": ["cpmcp-oren"]
    }
  }
}
