get-user-contest-ranking
Retrieve LeetCode contest ranking data for a specific user to analyze their competitive programming performance and track progress in coding competitions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | LeetCode username |
Implementation Reference
- src/tools/contest-tools.ts:37-52 (handler)The handler function that executes the tool: fetches user contest ranking using LeetCodeService, returns formatted JSON or error response.async ({ username }) => { try { const data = await leetcodeService.fetchUserContestRanking(username); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true }; }
- src/tools/contest-tools.ts:34-36 (schema)Zod input schema defining the 'username' parameter for the tool.{ username: z.string().describe("LeetCode username") },
- src/tools/contest-tools.ts:32-54 (registration)Registration of the 'get-user-contest-ranking' tool on the MCP server within registerContestTools.server.tool( "get-user-contest-ranking", { username: z.string().describe("LeetCode username") }, async ({ username }) => { try { const data = await leetcodeService.fetchUserContestRanking(username); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true }; } } );
- LeetCodeService helper method that calls the GraphQL query for user contest ranking data.async fetchUserContestRanking(username: string) { return this.executeQuery(userContestRankingQuery, { username }); }
- src/graphql/queries.ts:197-223 (helper)GraphQL query used to fetch user contest ranking and history data from LeetCode API.export const userContestRankingQuery = ` query userContestRankingInfo($username: String!) { userContestRanking(username: $username) { attendedContestsCount rating globalRanking totalParticipants topPercentage badge { name } } userContestRankingHistory(username: $username) { attended trendDirection problemsSolved totalProblems finishTimeInSeconds rating ranking contest { title startTime } } } `;
- src/index.ts:24-24 (registration)Invocation of registerContestTools in main server setup, which registers the tool.registerContestTools(server, leetcodeService);