AtCoder MCP server
Commit Sep 8, 2026Search AtCoder problems and fetch public problem statements through an MCP interface.
Also known as ketherworks/atcoder-mcp-server, atcoder-mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Sep 8, 2026
- License
- MIT
What is AtCoder MCP?
AtCoder searches AtCoder problems and fetch public problem statements through an MCP interface.
Summary generated from the project's README
About AtCoder MCP server
Finding and reading past AtCoder competitive programming problems directly through an AI client is what this server enables. Developers and students can use it to retrieve problem statements and sample data for practice without leaving their chat interface. It works both as a local installation using Node.js 22 or via a hosted HTTP endpoint that requires no API keys, cookies, or judge account credentials.
The server provides specific tools for interacting with the AtCoder database. You can use oj_search_problems to resolve specific task identifiers and oj_fetch_problem to pull the full content of a single past problem using its canonical URL or contest ID. It also includes oj_capabilities to list available operations and oj_health to check the status of the connection and upstream reads.
Because this tool is intended for practicing with historical problems, it does not include any tools for running or submitting code to a judge. Users should avoid using this server during active ABC, ARC, or AGC contests to comply with platform rules regarding generative AI.
What you can do with it
- 1Retrieve specific problem detailsAsk the AI to fetch a specific AtCoder problem and display its sample inputs and outputs.
- 2Locate problems by identifierUse the search tool to find a problem when you only have a contest or task ID.
- 3Check server connectivityVerify if the MCP server is ready and check the status of the last upstream data read.
Written from the project's README. Every use case is checked against a quote from it.
How to install AtCoder MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AtCoder MCP in Claude Code
$ claude mcp add --transport http atcoder-mcp-server https://api.ksrnyx.top/oj-mcp/atcoder/mcpInstall AtCoder MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"atcoder-mcp-server": {
"url": "https://api.ksrnyx.top/oj-mcp/atcoder/mcp"
}
}
}Install AtCoder MCP in VS Code
.vscode/mcp.json
{
"servers": {
"atcoder-mcp-server": {
"type": "http",
"url": "https://api.ksrnyx.top/oj-mcp/atcoder/mcp"
}
}
}Install AtCoder MCP in VS Code CLI
$ code --add-mcp '{"name":"atcoder-mcp-server","type":"http","url":"https://api.ksrnyx.top/oj-mcp/atcoder/mcp"}'Install AtCoder MCP in Codex
$ codex mcp add atcoder-mcp-server --url https://api.ksrnyx.top/oj-mcp/atcoder/mcpInstall AtCoder MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.atcoder-mcp-server] url = "https://api.ksrnyx.top/oj-mcp/atcoder/mcp"
Install AtCoder MCP in Gemini CLI
$ gemini mcp add -s user --transport http atcoder-mcp-server https://api.ksrnyx.top/oj-mcp/atcoder/mcpInstall AtCoder MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"atcoder-mcp-server": {
"url": "https://api.ksrnyx.top/oj-mcp/atcoder/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/atcoder-mcp-server is public and reachablegithub.com/ketherworks/atcoder-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/atcoder-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 handshakeinitialize answered with protocol 2025-06-18 in 230 msPass
README
View on GitHubAtCoder MCP Server
Find and read past AtCoder problems through MCP, locally or over hosted HTTP.
Quick Start
Add the hosted server to your MCP configuration:
{
"servers": {
"atcoder": {
"type": "http",
"url": "https://api.ksrnyx.top/oj-mcp/atcoder/mcp"
}
}
}
The endpoint accepts anonymous read requests. It does not need an API key, Cookie, or judge account.
Then ask:
Fetch AtCoder problem abc086_a and show its samples.
What It Can Do
| Tool | Purpose |
|---|---|
oj_capabilities |
Report the available AtCoder read operations and transport. |
oj_health |
Report process readiness and the latest upstream read. |
oj_fetch_problem |
Fetch one past problem by canonical URL or contest/task id. |
oj_search_problems |
Resolve an exact task URL or contest/task identifier. |
Run Locally
Requires Node.js 22 or newer.
npm ci
npm run check
npm run build
node packages/atcoder/dist/index.js
MCP client configuration from a source checkout:
{
"servers": {
"atcoder": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/packages/atcoder/dist/index.js"]
}
}
}
Tagged GitHub releases attach a standalone npm tarball.
Availability
- Hosted MCP:
https://api.ksrnyx.top/oj-mcp/atcoder/mcp - Official MCP Registry:
io.github.ketherworks/atcoder, 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
Do not use this server during ongoing ABC, ARC, or AGC contests. AtCoder's current generative-AI rules generally prohibit that use. This project is intended for practice with past problems. It is unofficial and is not affiliated with or endorsed by AtCoder Inc. Problem content remains subject to the AtCoder Terms of Use.
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.
AtCoder MCP questions
How do I add AtCoder MCP to Claude Code?
Run claude mcp add --transport http atcoder-mcp-server https://api.ksrnyx.top/oj-mcp/atcoder/mcp in your terminal. Add --scope user to make it available in every project.
How do I add AtCoder MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this server require an API key or account?
No, the endpoint accepts anonymous read requests and does not require an API key, Cookie, or judge account.
Can I use this server during live contests?
No, you should not use this server during ongoing ABC, ARC, or AGC contests due to AtCoder's generative AI rules.
Can I submit solutions using this server?
No, the server only provides read operations and does not expose any run or submit tools.