{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_tksxtnpagz4j","handle":"oj-mcp-server","url":"https://wellknown.network/agents/oj-mcp-server","links":{"self":"https://wellknown.network/agents/oj-mcp-server/record.json","html":"https://wellknown.network/agents/oj-mcp-server","markdown":"https://wellknown.network/agents/oj-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/oj-mcp-server","status":"https://wellknown.network/api/v1/agents/oj-mcp-server/status","claim":"https://wellknown.network/agents/oj-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/oj-mcp-server/claim.json","badge":"https://wellknown.network/agents/oj-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/oj-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/oj-mcp-server/tools"},"ard":{"identifier":"urn:air::server:oj-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"oj-mcp-server","summary":"MCP server for an Online Judge","description":"# Online Judge MCP Server\n\n![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)\n[![PyPI](https://img.shields.io/pypi/v/oj-mcp-server.svg)](https://pypi.org/project/oj-mcp-server/)\n[![License](https://img.shields.io/github/license/wangicheng/oj-mcp-server.svg)](https://github.com/wangicheng/oj-mcp-server/blob/main/LICENSE)\n\n<a href=\"https://glama.ai/mcp/servers/@wangicheng/oj-mcp-server\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@wangicheng/oj-mcp-server/badge\" />\n</a>\n\nThis is a Model Context Protocol (MCP) server that provides AI agents with tools to interact with an Online Judge API.\n\n## Features\n\nProvides the following tools:\n- `list_problems(offset, limit)`: List available problems on the OJ.\n- `list_my_submissions(offset, limit)`: List recent submissions made by the authenticated user.\n- `get_problem_details(problem_id)`: Fetch detailed descriptions, samples, limits, and rules of a problem.\n- `submit_code(problem_id, code, language)`: Submit source code to a specific problem.\n- `get_submission_status(submission_id)`: Check the polling status of a code submission.\n\n## Quickstart\n\n### Using `uvx` (Recommended)\nThe easiest way to run this server is using [`uvx`](https://docs.astral.sh/uv/), which automatically downloads the correct Python version, creates an ephemeral environment, and runs the tool seamlessly:\n\n```bash\nset OJ_URL=\"http://localhost:8000\" # Replace with actual OJ URL\nset OJ_USERNAME=\"your-username\"\nset OJ_PASSWORD=\"your-password\"\n\nuvx oj-mcp-server\n```\n\n### Using `pip` or `pipx`\nAlternatively, you can install the package directly into your Python environment:\n\n```bash\npip install oj-mcp-server\noj-mcp-server\n```\n\n## Usage with MCP Clients\n\nTo use this server, add it to your MCP client's configuration (e.g., Claude Desktop, Cursor, Cline).\n\n### Claude Desktop\n\nAdd the following to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"oj-mcp-server\": {\n      \"command\": \"uvx\",\n      \"args\": [\"oj-…","publisher":null,"homepage":"https://github.com/wangicheng/oj-mcp-server","repository":"https://github.com/wangicheng/oj-mcp-server/issues","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["ai-tools","mcp","mcp-server","online-judge"],"pricing":null,"endpoints":[{"url":"pypi:oj-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"ai.evaluation","name":"Evaluation & Benchmarks","confidence":0.997,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["ai","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"oj-mcp-server","registry":"pypi","observedAt":"2026-10-28T18:28:20.838Z","publishedAt":"2026-02-24T15:13:46.711139Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"oj-mcp-server","url":"https://pypi.org/project/oj-mcp-server/","firstSeenAt":"2026-09-10T08:26:15.865Z","fetchedAt":"2026-10-28T18:26:55.870Z","normalizedAt":"2026-10-28T18:26:55.870Z"}]},"firstSeenAt":"2026-09-10T08:26:15.865Z","updatedAt":"2026-10-28T18:28:20.838Z"}