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);
```
src/services/leetcode-service.ts:101-103 (helper)
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
    };
  }
}

mcp-server-leetcode