Codeforces MCP Server

io.github.ketherworksPublished by GitHub account ketherworksv0.1.0Updated Nov 2, 2026

Search Codeforces problems and inspect public problem metadata through the official Codeforces API.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingDeveloper Tools

Overview

AI-generated overview

Hosted MCP server that lets an assistant search Codeforces problems and read official problem metadata through the Codeforces API.

What you can do
  • Search the official Codeforces problemset by title, id, rating or tag
  • Fetch official problem metadata by id, accepting forms such as 158/A, 158A or 158-A
  • Report available read operations and transport, and check service health with the latest API observation
When to use it
Useful when you want an assistant to find practice problems by difficulty or tag, or look up details of a specific Codeforces problem, without leaving the chat.
Requirements
A remote streamable HTTP endpoint; no API key, cookie or judge account is needed for anonymous read requests. Running from source instead requires Node.js 22 or newer.
Before you install
Unofficial and not affiliated with Codeforces. It only reads public problem data and exposes no run or submit tool, so it cannot solve or submit problems on your behalf.

Installation

In SourceWeft

  1. Open Codeforces MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ketherworks%2Fcodeforces/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "codeforces": {
      "type": "http",
      "url": "https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"
    }
  }
}

README

Codeforces MCP Server

简体中文

Search official Codeforces problem metadata through a small MCP server.

Quick Start

Add the hosted server to your MCP configuration:

json
{  "servers": {    "codeforces": {      "type": "http",      "url": "https://codeforces-mcp.ksrnyx.top/mcp"    }  }}

The endpoint accepts anonymous read requests. It does not need an API key, Cookie, or judge account.

Then ask:

text
Find five beginner Codeforces problems tagged implementation.

What It Can Do

ToolPurpose
oj_capabilitiesReport the available Codeforces read operations and transport.
oj_healthReport service health and the latest official API observation.
oj_search_problemsSearch the official problemset by title, id, rating, or tag.
codeforces_get_problem_metadataFetch official metadata by id, such as 158/A, 158A, or 158-A.

Run Locally

Requires Node.js 22 or newer.

bash
npm cinpm run checknpm run buildnode packages/codeforces/dist/index.js

MCP client configuration from a source checkout:

json
{  "servers": {    "codeforces": {      "type": "stdio",      "command": "node",      "args": ["/absolute/path/packages/codeforces/dist/index.js"]    }  }}

Tagged GitHub releases attach a standalone npm tarball.

Availability

  • Hosted MCP: https://codeforces-mcp.ksrnyx.top/mcp
  • Official MCP Registry: io.github.ketherworks/codeforces, described by server.json
  • Health status: see the repository homepage or call oj_health

Source and Safety

This standalone release is generated from the reviewed Competitive Programming MCP source. The release package bundles the shared OJ contract implementation, so its runtime does not depend on unpublished workspace packages.

Platform Rules

This project is unofficial and is not affiliated with or endorsed by Codeforces.

The server exposes no run or submit tool. It accepts no judge account credentials. See SECURITY.md for the security boundary and PROVENANCE.md for the canonical source revision.

Development

bash
npm cinpm run checknpm run pack:checknpm run deploy:dry

License

Adapter source code is MIT licensed. Judge problem content and trademarks are not relicensed by this repository.

Source: README.md at commit c34dbcc

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts