{
  "markdown": "# Codeforces MCP Server\n\n[简体中文](README.zh-CN.md)\n\nSearch official Codeforces problem metadata through a small MCP server.\n\n## Quick Start\n\nAdd the hosted server to your MCP configuration:\n\n```json\n{\n  \"servers\": {\n    \"codeforces\": {\n      \"type\": \"http\",\n      \"url\": \"https://codeforces-mcp.ksrnyx.top/mcp\"\n    }\n  }\n}\n```\n\nThe endpoint accepts anonymous read requests. It does not need an API key, Cookie, or judge account.\n\nThen ask:\n\n```text\nFind five beginner Codeforces problems tagged implementation.\n```\n\n## What It Can Do\n\n| Tool | Purpose |\n| --- | --- |\n| `oj_capabilities` | Report the available Codeforces read operations and transport. |\n| `oj_health` | Report service health and the latest official API observation. |\n| `oj_search_problems` | Search the official problemset by title, id, rating, or tag. |\n| `codeforces_get_problem_metadata` | Fetch official metadata by id, such as `158/A`, `158A`, or `158-A`. |\n\n## Run Locally\n\nRequires Node.js 22 or newer.\n\n```bash\nnpm ci\nnpm run check\nnpm run build\nnode packages/codeforces/dist/index.js\n```\n\nMCP client configuration from a source checkout:\n\n```json\n{\n  \"servers\": {\n    \"codeforces\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/packages/codeforces/dist/index.js\"]\n    }\n  }\n}\n```\n\nTagged GitHub releases attach a standalone npm tarball.\n\n## Availability\n\n- Hosted MCP: `https://codeforces-mcp.ksrnyx.top/mcp`\n- Official MCP Registry: `io.github.ketherworks/codeforces`, described by [`server.json`](server.json)\n- Health status: see the repository homepage or call `oj_health`\n\n## Source and Safety\n\nThis standalone release is generated from the reviewed\n[Competitive Programming MCP source](https://github.com/ketherworks/competitive-programming-mcp/tree/a63a43780d866804c88a938849f92558f08fe403/packages/codeforces).\nThe release package bundles the shared OJ contract implementation, so its runtime does not depend\non unpublished workspace packages.\n\n## Platform Rules\n\nThis project is unofficial and is not affiliated with or endorsed by Codeforces.\n\nThe server exposes no run or submit tool. It accepts no judge account credentials. See\n[SECURITY.md](SECURITY.md) for the security boundary and [PROVENANCE.md](PROVENANCE.md) for the\ncanonical source revision.\n\n## Development\n\n```bash\nnpm ci\nnpm run check\nnpm run pack:check\nnpm run deploy:dry\n```\n\n## License\n\nAdapter source code is MIT licensed. Judge problem content and trademarks are not relicensed by\nthis repository.\n",
  "bytes": 2489,
  "sha": "776700b6e2a431b75e46b1aa8d8741483007aaec39ffe8977cfc4fac7c65ca9c",
  "repo_slug": "ketherworks/codeforces-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ketherworks_codeforces_d0214b73/readme"
}