get-contest-details
Retrieve contest information from LeetCode using the contest URL slug to access details about programming competitions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contestSlug | Yes | The URL slug of the contest |
Implementation Reference
- src/tools/contest-tools.ts:7-29 (registration)Primary registration of the 'get-contest-details' tool, including input schema (contestSlug: string) and inline handler that fetches data from LeetCodeService and returns formatted JSON response or error.server.tool( "get-contest-details", { contestSlug: z.string().describe("The URL slug of the contest") }, async ({ contestSlug }) => { try { const data = await leetcodeService.fetchContestDetails(contestSlug); 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/index.ts:24-24 (registration)Top-level registration call that invokes registerContestTools to add the get-contest-details tool (among others) to the MCP server.registerContestTools(server, leetcodeService);
- Supporting service method in LeetCodeService that executes the GraphQL query to fetch contest details by slug.async fetchContestDetails(contestSlug: string) { return this.executeQuery(contestDetailsQuery, { contestSlug }); }
- src/graphql/queries.ts:177-195 (helper)GraphQL query definition used to fetch detailed contest information including title, description, timing, and participating questions.export const contestDetailsQuery = ` query contestData($contestSlug: String!) { contest(titleSlug: $contestSlug) { title titleSlug description startTime duration originStartTime isVirtual questions { questionId title titleSlug difficulty } } } `;
- src/tools/contest-tools.ts:12-28 (handler)Inline handler function within the tool registration that processes the input, calls the service, and structures the MCP-compatible response.async ({ contestSlug }) => { try { const data = await leetcodeService.fetchContestDetails(contestSlug); 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 }; } }