contest_list
Pack: codeforces · Endpoint: https://gateway.pipeworx.io/codeforces/mcp
All contests. Pass gym=true for gym contests.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
gym | boolean | no |
Example call
curl -X POST https://gateway.pipeworx.io/codeforces/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"contest_list","arguments":{}}}'Response shape
Always returns: status
| Field | Type | Description |
|---|---|---|
status | string | Response status (OK or FAILED) |
result | array | Array of contest objects |
comment | string | Error comment (if status is FAILED) |
Full JSON Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Response status (OK or FAILED)"
},
"result": {
"type": "array",
"description": "Array of contest objects",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "Contest ID"
},
"name": {
"type": "string",
"description": "Contest name"
},
"type": {
"type": "string",
"description": "Contest type (CF, IOI, ICPC)"
},
"phase": {
"type": "string",
"description": "Contest phase (BEFORE, CODING, PENDING_SYSTEM_TEST, SYSTEM_TEST, FINISHED)"
},
"frozen": {
"type": "boolean",
"description": "Is scoreboard frozen"
},
"durationSeconds": {
"type": "number",
"description": "Contest duration in seconds"
},
"startTimeSeconds": {
"type": "number",
"description": "Unix timestamp of contest start"
},
"relativeTimeSeconds": {
"type": "number",
"description": "Seconds since contest start (if started)"
},
"preparedBy": {
"type": "string",
"description": "Prepared by (handle)"
},
"websiteUrl": {
"type": "string",
"description": "Contest website URL"
},
"description": {
"type": "string",
"description": "Contest description"
},
"difficulty": {
"type": "number",
"description": "Difficulty level"
},
"kind": {
"type": "string",
"description": "Contest kind"
},
"icpcPhase": {
"type": "string",
"description": "ICPC contest phase"
},
"country": {
"type": "string",
"description": "Country code"
},
"city": {
"type": "string",
"description": "City name"
},
"season": {
"type": "string",
"description": "Season name"
}
}
}
},
"comment": {
"type": "string",
"description": "Error comment (if status is FAILED)"
}
},
"required": [
"status"
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"codeforces": {
"url": "https://gateway.pipeworx.io/codeforces/mcp"
}
}
}See Getting Started for client-specific install steps.