product-hunt-mcp

Instructions

    Retrieve a list of collections with optional filters.

    Parameters:
    - featured (bool, optional): Only return featured collections if True.
    - user_id (str, optional): Filter to collections created by this user ID.
    - post_id (str, optional): Filter to collections that include this post ID.
    - order (str, optional): Sorting order. Valid values: FOLLOWERS_COUNT (default), NEWEST.
    - count (int, optional): Number of collections to return (default: 10, max: 20).
    - after (str, optional): Pagination cursor for next page.

    Returns:
    - success (bool)
    - data (dict): If successful, contains:
        - collections (list): List of collection objects (id, name, etc.)
        - pagination (dict): { end_cursor, has_next_page }
    - error (dict, optional)
    - rate_limits (dict)

    Notes:
    - If no collections match, `collections` will be an empty list.
    

Implementation Reference

• src/product_hunt_mcp/tools/collections.py:68-145 (handler)

  The handler function decorated with @mcp.tool(), handling input validation, authentication, error handling, GraphQL query execution for retrieving collections with filters and pagination, and response formatting.

  @mcp.tool()
  @require_token
  @handle_errors
  @validate_with_schema(COLLECTIONS_SCHEMA)
  def get_collections(
      featured: bool = None,
      user_id: str = None,
      post_id: str = None,
      order: str = "FOLLOWERS_COUNT",
      count: int = 10,
      after: str = None,
  ) -> Dict[str, Any]:
      """
      Retrieve a list of collections with optional filters.
  
      Parameters:
      - featured (bool, optional): Only return featured collections if True.
      - user_id (str, optional): Filter to collections created by this user ID.
      - post_id (str, optional): Filter to collections that include this post ID.
      - order (str, optional): Sorting order. Valid values: FOLLOWERS_COUNT (default), NEWEST.
      - count (int, optional): Number of collections to return (default: 10, max: 20).
      - after (str, optional): Pagination cursor for next page.
  
      Returns:
      - success (bool)
      - data (dict): If successful, contains:
          - collections (list): List of collection objects (id, name, etc.)
          - pagination (dict): { end_cursor, has_next_page }
      - error (dict, optional)
      - rate_limits (dict)
  
      Notes:
      - If no collections match, `collections` will be an empty list.
      """
      params = {
          k: v
          for k, v in {
              "featured": featured,
              "user_id": user_id,
              "post_id": post_id,
              "order": order,
              "count": count,
              "after": after,
          }.items()
          if v is not None
      }
      logger.info("collections.get_collections called", extra=params)
  
      # Apply pagination defaults
      variables = apply_pagination_defaults(count, after)
  
      # Add order parameter
      variables["order"] = order
  
      # Add optional filters
      if featured is not None:
          variables["featured"] = featured
      if user_id:
          variables["userId"] = user_id
      if post_id:
          variables["postId"] = post_id
  
      result, rate_limits, error = execute_graphql_query(COLLECTIONS_QUERY, variables)
  
      if error:
          return format_response(False, error=error, rate_limits=rate_limits)
  
      # Extract collections
      collections_data = result["data"]["collections"]
  
      return format_response(
          True,
          data={
              "collections": collections_data["edges"],
              "pagination": extract_pagination(collections_data["pageInfo"]),
          },
          rate_limits=rate_limits,
      )

• src/product_hunt_mcp/schemas/validation.py:39-46 (schema)

  JSON schema defining validation rules for the input parameters of the get_collections tool.

  COLLECTIONS_SCHEMA = {
      "featured": {"type": bool},
      "user_id": {"type": str},
      "post_id": {"type": str},
      "order": {"type": str, "valid_values": ["FOLLOWERS_COUNT", "NEWEST", "FEATURED_AT"]},
      "count": {"type": int, "min_value": 1, "max_value": 20},
      "after": {"type": str},
  }

• src/product_hunt_mcp/cli.py:37-37 (registration)

  Entry point registration: calls register_collection_tools to register the collections tools (including get_collections) with the MCP server instance.

  register_collection_tools(mcp)

• src/product_hunt_mcp/tools/collections.py:24-27 (registration)

  Defines and registers the collection tools (get_collection and get_collections) using @mcp.tool() decorators when called with an MCP instance.

  def register_collection_tools(mcp):
      """Register collection-related tools with the MCP server."""
  
      @mcp.tool()