Codeforces MCP server
Commit Sep 8, 2026Search official Codeforces problem metadata and browse the problemset by title, rating, or tag through an AI client.
Also known as ketherworks/codeforces-mcp-server, codeforces-mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Sep 8, 2026
- License
- MIT
What is Codeforces MCP?
Codeforces searches official Codeforces problem metadata and browse the problemset by title, rating, or tag through an AI client.
Summary generated from the project's README
About Codeforces MCP server
Finding specific competitive programming challenges through an AI client is what this server enables. It allows users to browse the official Codeforces problemset by searching for titles, IDs, ratings, or specific tags. This tool is designed for developers and competitive programmers who want to query problem metadata without leaving their chat interface.
Users can connect to the hosted version via HTTP or run it locally using Node.js 22. The server operates through anonymous read requests, meaning it requires no API keys, cookies, or judge account credentials to function. It provides specific tools like oj_search_problems for finding challenges and codeforces_get_problem_metadata for retrieving detailed information using identifiers such as 158/A or 158A.
Because the server only exposes read operations, it maintains a strict security boundary by not including any tools to run or submit code. You can check the status of the service at any time using the oj_health tool to see the latest official API observations.
What you can do with it
- 1Discovering themed practice problemsAsk the AI to find a specific number of beginner problems that use a particular programming tag.
- 2Searching the problemset by difficultySearch for challenges based on their official rating or title.
Written from the project's README. Every use case is checked against a quote from it.
How to install Codeforces MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Codeforces MCP in Claude Code
$ claude mcp add --transport http codeforces-mcp-server https://codeforces-oj-mcp.lantangtang54.workers.dev/mcpInstall Codeforces MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codeforces-mcp-server": {
"url": "https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"
}
}
}Install Codeforces MCP in VS Code
.vscode/mcp.json
{
"servers": {
"codeforces-mcp-server": {
"type": "http",
"url": "https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"
}
}
}Install Codeforces MCP in VS Code CLI
$ code --add-mcp '{"name":"codeforces-mcp-server","type":"http","url":"https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"}'Install Codeforces MCP in Codex
$ codex mcp add codeforces-mcp-server --url https://codeforces-oj-mcp.lantangtang54.workers.dev/mcpInstall Codeforces MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.codeforces-mcp-server] url = "https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"
Install Codeforces MCP in Gemini CLI
$ gemini mcp add -s user --transport http codeforces-mcp-server https://codeforces-oj-mcp.lantangtang54.workers.dev/mcpInstall Codeforces MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codeforces-mcp-server": {
"url": "https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableketherworks/codeforces-mcp-server is public and reachablegithub.com/ketherworks/codeforces-mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-08github.com/ketherworks/codeforces-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: HTTP 500Finding
README
View on GitHubCodeforces MCP Server
Search official Codeforces problem metadata through a small MCP server.
Quick Start
Add the hosted server to your MCP configuration:
{
"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:
Find five beginner Codeforces problems tagged implementation.
What It Can Do
| Tool | Purpose |
|---|---|
oj_capabilities |
Report the available Codeforces read operations and transport. |
oj_health |
Report service health and the latest official API observation. |
oj_search_problems |
Search the official problemset by title, id, rating, or tag. |
codeforces_get_problem_metadata |
Fetch official metadata by id, such as 158/A, 158A, or 158-A. |
Run Locally
Requires Node.js 22 or newer.
npm ci
npm run check
npm run build
node packages/codeforces/dist/index.js
MCP client configuration from a source checkout:
{
"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 byserver.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
npm ci
npm run check
npm run pack:check
npm run deploy:dry
License
Adapter source code is MIT licensed. Judge problem content and trademarks are not relicensed by this repository.
Codeforces MCP questions
How do I add Codeforces MCP to Claude Code?
Run claude mcp add --transport http codeforces-mcp-server https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Codeforces MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an API key to use this server?
No, the endpoint accepts anonymous read requests without an API key, Cookie, or judge account.
Can I submit code to Codeforces using this server?
No, the server is limited to read operations and does not expose any run or submit tools.
How can I search for specific problems?
You can search the official problemset using the search tool by filtering for title, id, rating, or tag.