Product Hunt MCP Server

An MCP (Model Context Protocol) server that provides access to Product Hunt data through the Product Hunt API v2 (GraphQL).

Quick Start

npx @yilin-jing/producthunt-mcp

Features

This MCP server provides comprehensive access to Product Hunt data including:

Post Operations

• get_post - Get a Product Hunt post by ID or slug
• get_posts - Get posts with filtering and ordering options
• search_posts - Search posts by query

Collection Operations

• get_collection - Get a collection by ID or slug
• get_collections - Get collections with filtering options

User Operations

• get_user - Get a user by ID or username
• get_user_posts - Get posts made by a specific user
• get_user_voted_posts - Get posts upvoted by a specific user

Topic Operations

• get_topic - Get a topic by ID or slug
• get_topics - Get topics with filtering options

Comment Operations

• get_comment - Get a comment by ID
• get_post_comments - Get comments on a specific post

Goal Operations

• get_goal - Get a maker goal by ID
• get_goals - Get maker goals with filtering options

Maker Group Operations

• get_maker_group - Get a maker group (Space) by ID
• get_maker_groups - Get maker groups with filtering options

Viewer Operations

• get_viewer - Get the authenticated user information

Installation

Using npx (Recommended)

No installation required! Just configure Claude Desktop to use the server directly via npx.

Global Installation

npm install -g @yilin-jing/producthunt-mcp

Local Development

git clone https://github.com/Jing-yilin/producthunt-mcp-server.git
cd producthunt-mcp-server
npm install
npm run build

Configuration

Environment Variables

| Variable | Description | |----------|-------------| | PRODUCTHUNT_ACCESS_TOKEN or PH_ACCESS_TOKEN | Your Product Hunt API access token (required) | | PROXY_URL | HTTP/HTTPS proxy URL (optional) |

Getting an Access Token

1. Go to Product Hunt API Dashboard
2. Create a new application or use an existing one
3. Generate a Developer Token for simple scripts, or implement OAuth for user-based access

Claude Desktop Configuration

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (Recommended)

{
  "mcpServers": {
    "producthunt": {
      "command": "npx",
      "args": ["-y", "@yilin-jing/producthunt-mcp"],
      "env": {
        "PRODUCTHUNT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

Using Global Installation

{
  "mcpServers": {
    "producthunt": {
      "command": "producthunt-mcp",
      "env": {
        "PRODUCTHUNT_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

Usage Examples

Get Today's Featured Posts

Get the featured posts from Product Hunt today

Get a Specific Product

Get the Product Hunt post for "ChatGPT"

Get User Information

Get the Product Hunt profile for username "rrhoover"

Get Posts by Topic

Get the latest AI products on Product Hunt

Get Collections

Get the featured collections on Product Hunt

API Reference

Post Endpoints

get_post

Get a Product Hunt post by ID or slug.

Parameters:

• id (string, optional): Post ID
• slug (string, optional): Post slug

get_posts

Get posts with filtering and ordering.

Parameters:

• featured (boolean, optional): Filter by featured posts only
• topic (string, optional): Filter by topic slug
• postedAfter (string, optional): Filter posts after this date (ISO 8601)
• postedBefore (string, optional): Filter posts before this date (ISO 8601)
• order (string, optional): Order by 'FEATURED_AT', 'NEWEST', 'RANKING', 'VOTES'
• first (integer, optional): Number of posts to return (default: 10, max: 20)
• after (string, optional): Cursor for pagination

search_posts

Search posts by query.

Parameters:

• query (string, required): Search query
• first (integer, optional): Number of posts to return
• after (string, optional): Cursor for pagination

Collection Endpoints

get_collection

Get a collection by ID or slug.

Parameters:

• id (string, optional): Collection ID
• slug (string, optional): Collection slug

get_collections

Get collections with filtering.

Parameters:

• featured (boolean, optional): Filter by featured collections
• userId (string, optional): Filter by user ID
• postId (string, optional): Filter by post ID
• order (string, optional): Order by 'FEATURED_AT', 'FOLLOWERS_COUNT', 'NEWEST'
• first (integer, optional): Number of collections to return
• after (string, optional): Cursor for pagination

User Endpoints

get_user

Get a user by ID or username.

Parameters:

• id (string, optional): User ID
• username (string, optional): Username

get_user_posts

Get posts made by a user.

Parameters:

• username (string, required): Username
• first (integer, optional): Number of posts to return
• after (string, optional): Cursor for pagination

get_user_voted_posts

Get posts upvoted by a user.

Parameters:

• username (string, required): Username
• first (integer, optional): Number of posts to return
• after (string, optional): Cursor for pagination

Topic Endpoints

get_topic

Get a topic by ID or slug.

Parameters:

• id (string, optional): Topic ID
• slug (string, optional): Topic slug

get_topics

Get topics with filtering.

Parameters:

• search (string, optional): Search topics by name
• order (string, optional): Order by 'FOLLOWERS_COUNT', 'NEWEST'
• first (integer, optional): Number of topics to return
• after (string, optional): Cursor for pagination

Comment Endpoints

get_comment

Get a comment by ID.

Parameters:

• id (string, required): Comment ID

get_post_comments

Get comments on a post.

Parameters:

• postId (string, optional): Post ID
• postSlug (string, optional): Post slug
• order (string, optional): Order by 'NEWEST', 'VOTES_COUNT'
• first (integer, optional): Number of comments to return
• after (string, optional): Cursor for pagination

Goal Endpoints

get_goal

Get a maker goal by ID.

Parameters:

• id (string, required): Goal ID

get_goals

Get maker goals with filtering.

Parameters:

• userId (string, optional): Filter by user ID
• makerGroupId (string, optional): Filter by maker group ID
• completed (boolean, optional): Filter by completion status
• order (string, optional): Order by 'COMPLETED_AT', 'DUE_AT', 'NEWEST'
• first (integer, optional): Number of goals to return
• after (string, optional): Cursor for pagination

Maker Group Endpoints

get_maker_group

Get a maker group (Space) by ID.

Parameters:

• id (string, required): Maker Group ID

get_maker_groups

Get maker groups with filtering.

Parameters:

• userId (string, optional): Filter by user ID
• order (string, optional): Order by 'GOALS_COUNT', 'LAST_ACTIVE', 'MEMBERS_COUNT', 'NEWEST'
• first (integer, optional): Number of groups to return
• after (string, optional): Cursor for pagination

Viewer Endpoints

get_viewer

Get the authenticated user information and their data.

No parameters required.

Pagination

All list endpoints support cursor-based pagination using the after parameter. The response includes a pageInfo object with:

• hasNextPage (boolean): Whether there are more results
• hasPreviousPage (boolean): Whether there are previous results
• startCursor (string): Cursor for the first item
• endCursor (string): Cursor for the last item (use this for the after parameter)

Rate Limits

The Product Hunt API has rate limits. Please refer to the official documentation for current limits.

Publishing

To publish a new version to npm:

npm version patch  # or minor, major
npm publish

License

MIT

Credits

• Uses Product Hunt API v2 (GraphQL)
• Built with Model Context Protocol SDK