Unstop MCP Server

Instructions

Implementation Reference

• src/unstop_mcp/server.py:67-71 (handler)

  The MCP tool handler in server.py that calls the service layer.

  def get_hackathon_details(hackathon_id: int) -> dict:
      try:
          return service.get_hackathon_details(hackathon_id).model_dump(mode="json")
      except (UnstopValidationError, UnstopAPIError, ValueError) as exc:
          raise ValueError(str(exc)) from exc

• src/unstop_mcp/service.py:193-197 (handler)

  The actual service implementation that fetches and normalizes hackathon details.

  def get_hackathon_details(self, hackathon_id: int) -> HackathonDetailResponse:
      raw = self.fetch_detail(hackathon_id)
      detail = self.parse_detail(raw)
      item = self.normalize_hackathon(detail)
      return HackathonDetailResponse(item=item, cache=self.cache.metadata(is_cached_result=False))

• src/unstop_mcp/server.py:64-66 (registration)

  Registration of the get_hackathon_details tool.

      name="get_hackathon_details",
      description="Fetch full details for a single Unstop hackathon by ID.",
  )