English Français العربية

io.github.avinash111921/codeforces-mcp

Official registry Developer tools

Codeforces MCP server for competitive programming, upsolving, and automated stress testing.

Source code Documentation

What can you do with io.github.avinash111921/codeforces-mcp?

  • Profile & Stats: Fetch live user ratings, ranks, and recent verdict breakdowns.
  • Problem Scraping: Bypasses Cloudflare to extract full problem descriptions and exact sample test cases.
  • Local Sandbox: Compiles and executes C++ or Python solutions locally against official sample inputs.
  • Automated Stress Testing: Isolates minimal failing test cases by running your optimized code against a brute-force script and a random generator.
  • Rate-Limit Safe: Built-in queuing and caching ensures you never hit the Codeforces API 1-request-per-2-seconds limit.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package codeforces-mcp-avinash
Claude Code 
claude mcp add codeforces-mcp -- uvx codeforces-mcp-avinash==0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "codeforces-mcp": {
            "command": "uvx",
            "args": [
                "codeforces-mcp-avinash==0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Codeforces MCP Server

A Model Context Protocol (MCP) server for Codeforces competitive programming. This server enables AI coding assistants (like Claude, Cursor, and Cline) to autonomously fetch problem statements, analyze your submission history, recommend upsolving targets, and run automated local stress tests.

Features

  • Profile & Stats: Fetch live user ratings, ranks, and recent verdict breakdowns.
  • Problem Scraping: Bypasses Cloudflare to extract full problem descriptions and exact sample test cases.
  • Local Sandbox: Compiles and executes C++ or Python solutions locally against official sample inputs.
  • Automated Stress Testing: Isolates minimal failing test cases by running your optimized code against a brute-force script and a random generator.
  • Rate-Limit Safe: Built-in queuing and caching ensures you never hit the Codeforces API 1-request-per-2-seconds limit.

Installation & Usage

You can run this server seamlessly using uvx without manual installation. Add the following configuration to your preferred AI IDE.

Cursor

Add this to your MCP configuration (Settings > Features > MCP):

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

Frequently asked questions

What is io.github.avinash111921/codeforces-mcp?

Codeforces MCP server for competitive programming, upsolving, and automated stress testing.

How do I install io.github.avinash111921/codeforces-mcp?

It runs on your machine. In Claude Code: claude mcp add codeforces-mcp -- uvx codeforces-mcp-avinash==0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.avinash111921/codeforces-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.avinash111921/codeforces-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.avinash111921/codeforces-mcp?

It is published by avinash111921. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.