Polarsteps MCP Server

Instructions

Implementation Reference

• src/polarsteps_mcp/tools.py:43-52 (handler)

  The main handler function for the 'get_user_social' tool. It retrieves the user by username using _get_user, checks if found, and returns social info or error message.

  def get_user_social(
      polarsteps_client: PolarstepsClient, input: GetUserSocial
  ) -> list[TextContent]:
      user = _get_user(polarsteps_client, input.username)
      if user.id == -1:
          return single_text_content(
              f"User not found: No Polarsteps user exists with username={input.username}. Please verify the username is correct and the user's profile is public."
          )
      return single_text_content(user.to_social())

• src/polarsteps_mcp/tools.py:36-41 (schema)

  Pydantic schema/model for input validation of the get_user_social tool, requiring a 'username' field.

  class GetUserSocial(BaseModel):
      username: str = Field(
          ...,
          description="The username of the Polarstep user to look for.",
      )

• src/polarsteps_mcp/tools.py:207-211 (registration)

  Registration of the 'get_user_social' tool in the PolarstepsTool enum, including name, description, and schema.

  USER_SOCIAL = (
      "get_user_social",
      "Get a users' social information including: followers, followees, their count and if they're considered popular.",
      GetUserSocial,
  )

• src/polarsteps_mcp/server.py:48-51 (registration)

  Tool dispatch/registration in the MCP server's call_tool handler, matching on the tool name and calling the handler with client and parsed input.

  case PolarstepsTool.USER_SOCIAL:
      input = GetUserSocial(**args)
      return get_user_social(client, input)