# Codeforces

> Codeforces is a freemium MCP server for developer tools. Read-only MCP access to Codeforces users, contests, problems and submissions. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/codeforces
- **Repository:** https://github.com/pipeworx-io/mcp-codeforces
- **MCP Registry name:** io.github.pipeworx-io/codeforces
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a keyless bridge to the public Codeforces read API, exposing profiles, rating history, submission logs, contest lists, standings, problemset stats, recent actions and blog entries as MCP tools. Standings paging and handle filtering are handled by the Pipeworx gateway rather than upstream, so large scoreboards can be sliced without downloading everything at once.

The pack is part of the Pipeworx gateway, which also lists shared meta-tools such as ask_pipeworx alongside the Codeforces tools on the endpoint. Gym contest standings are not served because they require an authenticated Codeforces account.

It suits developers and competitive programmers who want an AI client to look up handles, ratings or contest results. The project is an independent, unofficial integration and is not affiliated with Codeforces.

## Features

- **User profiles and ratings:** Look up one or more handles and retrieve full rating history for a user.
- **Submission history:** Fetch a user's recent submissions, newest first, with paging by offset and count.
- **Contest listings and standings:** List regular or gym contests and read a round's final scoreboard with optional handle filtering.
- **Problemset with tag filter:** Browse problems with per-problem submission counts, optionally filtered by tag.
- **Recent activity feed:** Read the global recent-actions feed of new blog entries and comments.
- **Blog entry lookup:** Retrieve a full Codeforces blog entry by its id.

## Good for

- Check a competitor's rating trajectory before a contest
- Pull contest standings for a specific round into an analysis
- Find problems by tag to build a practice list
- Review a user's recent submissions and verdicts
- Monitor recent blog posts and comments on the platform

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http codeforces https://gateway.pipeworx.io/codeforces/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/codeforces/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "codeforces": {
      "url": "https://gateway.pipeworx.io/codeforces/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "codeforces": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/codeforces/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "codeforces": {
      "serverUrl": "https://gateway.pipeworx.io/codeforces/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "codeforces": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/codeforces/mcp"
    }
  }
}
```

## Tools

- `codeforces_user`: Profile(s) by handle, up to 10000 semicolon-separated.
- `user_rating`: Full rating history for a user.
- `user_status`: Recent submissions for a user, newest first, paged with from/count.
- `contest_list`: All contests, with gym option.
- `contest_standings`: Final scoreboard of one contest round.
- `problemset`: Problemset with per-problem submission counts and optional tag filter.
- `recent_actions`: Global recent-actions feed.
- `blog_entry_view`: Full blog entry by id.

## FAQ

### Does it need an API key?

The Codeforces tools are keyless. The README says an optional Pipeworx API key raises the daily call cap for anonymous use.

### Can it fetch gym contest standings?

No. The README says gym standings require an authenticated Codeforces account, so the pack returns a not-found reason instead.

### Why does the endpoint list more tools than the pack's table?

The README says the pack endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx, which route across the whole catalog.

### Is Codeforces free?

Codeforces has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Codeforces to Claude Code?

Run this command in your terminal: claude mcp add --transport http codeforces https://gateway.pipeworx.io/codeforces/mcp

### What are the best alternatives to Codeforces?

The closest alternatives to Codeforces are Leetcode, Codewars and Codecov MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Leetcode](https://ai-powered.com/mcp/leetcode): Leetcode is a freemium MCP server for developer tools.
- [Codewars](https://ai-powered.com/mcp/codewars): Codewars is a freemium MCP server for developer tools.
- [Codecov MCP by usefulapi](https://ai-powered.com/mcp/codecov-mcp-by-usefulapi): Codecov MCP by usefulapi is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/codeforces
