# Codeforces Mcp Server

Codeforces MCP Tools supercharges your AI with live competitive programming data. With 11 strictly-typed tools, it enables your AI agent to:

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add nakranimeet2005/codeforces-mcp-tools

# Browse available tools
npx -y smithery tool list nakranimeet2005/codeforces-mcp-tools

# Get full schema for a tool
npx -y smithery tool get nakranimeet2005/codeforces-mcp-tools get_user_stats

# Call a tool
npx -y smithery tool call nakranimeet2005/codeforces-mcp-tools get_user_stats '{}'
```

## Direct MCP Connection

Endpoint: `https://codeforces-mcp-tools--nakranimeet2005.run.tools`

## Tools (11)

- `get_user_stats` — Fetch complete user profile, rating, rank, and solve counts.
- `get_recent_activity` — Fetch complete the most recently solved Problem , Contest , Points , Link , Tags, by the user.
- `get_tag_breakdown` — Fetch all accepted submissions for a user and calculate how many unique problems they have solved for each topic tag (e…
- `get_best_contest_rank` — Fetch the user's best ever performance (highest rank) in a single Codeforces contest.
- `analyze_weak_topics` — Identify underperforming tags and suggest focus areas based on the user's lowest solve counts.
- `get_rating_history` — Fetch the user's rating changes over time, including their latest contest performances and overall rating trajectory.
- `get_virtual_contest` — Suggest custom practice virtual contests based on the user's rating, excluding ones they have already competed in.
- `get_recommend_problems` — Smart problem suggestions based on the user's current rating and their weakest topic areas.
- `get_search_problems` — Search the Codeforces problem set by specific tags, minimum rating, and maximum rating.
- `get_problem_stats` — Fetch deep statistics for a specific Codeforces problem, including its rating, global solve count, and topic tags.
- `compare_users` — Compare two Codeforces users side-by-side, including their ratings, total solves, problem overlap, and unique solves.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get nakranimeet2005/codeforces-mcp-tools <tool-name>
```
