Product Hunt MCP Server

Product Hunt MCP Server

Plug-and-play MCP server for accessing Product Hunt data with LLMs and agents.

33
Stars
8
Forks
33
Watchers
5
Issues
Product Hunt MCP Server acts as a bridge between Product Hunt’s API and any agent or LLM that supports the Model Context Protocol (MCP). It enables fast and standardized access to posts, collections, topics, users, comments, and votes on Product Hunt. Built on FastMCP, it ensures seamless compatibility with popular AI tooling like Claude Desktop and Cursor. Integration is straightforward, requiring only a Product Hunt API token and simple configuration.

Key Features

MCP-compatible server for Product Hunt API
Retrieves posts, collections, topics, users, votes, comments
Search and filter by topic, date, and votes
Paginated access to comments and user upvotes
Built with FastMCP for speed and compatibility
Easy integration with Claude Desktop and Cursor
Python 3.10+ support
Docker-ready deployment
Environment variable-based API token handling
Quick setup via PyPI, GitHub, or source

Use Cases

Integrate Product Hunt data into AI assistants or chatbots
Automate discovery and tracking of new Product Hunt posts
Build dashboards for monitoring Product Hunt activity
Enable LLMs to contextualize conversations with real-time Product Hunt information
Develop bots that interact with or analyze Product Hunt users, votes, and comments
Enhance research or market analysis by pulling structured Product Hunt data
Personal productivity tools accessing collections and topics from Product Hunt
Support automated notification systems for new upvotes or comments
Facilitate experiments in the MCP ecosystem for tooling and prototyping
Custom automations leveraging real-time Product Hunt API access

README

🚀 Product Hunt MCP Server

PyPI version License: MIT Python 3.10+ Docker Ready MCP Compatible

A plug-and-play MCP server for Product Hunt


📦 Quick Install

bash
pip install product-hunt-mcp

🏃‍♂️ Quick Start Example

bash
# Run the MCP server (requires PRODUCT_HUNT_TOKEN environment variable)
export PRODUCT_HUNT_TOKEN=your_token_here
product-hunt-mcp

✨ What is this?

Product Hunt MCP Server connects Product Hunt's API to any LLM or agent that speaks the Model Context Protocol (MCP). Perfect for AI assistants, chatbots, or your own automations!

  • 🔍 Get posts, collections, topics, users
  • 🗳️ Get votes, comments, and more
  • 🛠️ Use with Claude Desktop, Cursor, or any MCP client

🛠️ Features

  • Get detailed info on posts, comments, collections, topics, users
  • Search/filter by topic, date, votes, etc.
  • Paginated comments, user upvotes, and more
  • Built with FastMCP for speed and compatibility

🧑‍💻 Who is this for?

  • AI/LLM users: Plug into Claude Desktop, Cursor, or your own agent
  • Developers: Build bots, dashboards, or automations with Product Hunt data
  • Tinkerers: Explore the MCP ecosystem and build your own tools

🏁 Setup

Prerequisites

  • Python 3.10+
  • Product Hunt API token (get one here)
    • You'll need to create an account on Product Hunt
    • Navigate to the API Dashboard and create a new application
    • Use the Developer Token for the token

Note: When creating a new application on Product Hunt, you will be asked for a redirect_uri. While the MCP server does not use the redirect URI, it is a required field. You can enter any valid URL, such as https://localhost:8424/callback.

Installation

Preferred: uv (fast, modern Python installer)

bash
# Install uv if you don't have it
pip install uv

Install from PyPI (recommended)

bash
uv pip install product-hunt-mcp
# or
pip install product-hunt-mcp

Install from GitHub (latest main branch)

bash
uv pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'
# or
pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'

Install locally from source

bash
uv pip install .
# or
pip install .

🚀 Usage with Claude Desktop & Cursor

Once installed, the product-hunt-mcp command will be available. Add it to your Claude Desktop or Cursor configuration:

json
{
  "mcpServers": {
    "product-hunt": {
      "command": "product-hunt-mcp",
      "env": {
        "PRODUCT_HUNT_TOKEN": "your_token_here"
      }
    }
  }
}
  • Replace your_token_here with your actual Product Hunt API token.
  • The token must be set as an environment variable in your Claude Desktop or Cursor config for the server to authenticate.
  • Always restart your client (Claude Desktop/Cursor) after editing the config file.

Tip: On macOS, Claude Desktop may not always find the product-hunt-mcp command if it's not in the default PATH. If you encounter issues, you can provide the full path to the executable. After installing, run:

bash
which product-hunt-mcp

Use the output path in your Claude Desktop config, replacing "command": "product-hunt-mcp" with the full path (e.g., "command": "/Users/youruser/.local/bin/product-hunt-mcp").

Finding your configuration file

  • Claude Desktop:

    • Windows: %APPDATA%\claude-desktop\config.json
    • macOS: ~/Library/Application Support/claude-desktop/config.json
    • Linux: ~/.config/claude-desktop/config.json
  • Cursor:

    • Windows: %APPDATA%\Cursor\User\settings.json
    • macOS: ~/Library/Application Support/Cursor/User/settings.json
    • Linux: ~/.config/Cursor/User/settings.json

Docker

You can also run the server using Docker:

bash
# Build the Docker image
docker build -t product-hunt-mcp .

# Run the Docker container (interactive for MCP)
docker run -i --rm -e PRODUCT_HUNT_TOKEN=your_token_here product-hunt-mcp

For Claude Desktop/Cursor integration with Docker, use this configuration:

json
{
  "mcpServers": {
    "product-hunt": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PRODUCT_HUNT_TOKEN=your_token_here", "product-hunt-mcp"],
      "env": {}
    }
  }
}

Security Note: Your PRODUCT_HUNT_TOKEN is sensitive. Do not share it or commit it to version control.


🛠️ MCP Tools

Tool Description Key Parameters
get_post_details Get info about a specific post id or slug, comments_count, comments_after
get_posts Get posts with filters topic, order, count, featured, posted_before, posted_after
get_comment Get info about a specific comment id (required)
get_post_comments Get comments for a post post_id or slug, order, count, after
get_collection Get info about a collection id or slug
get_collections Get collections with filters featured, user_id, post_id, order, count
get_topic Get info about a topic id or slug
search_topics Search topics query, followed_by_user_id, order, count
get_user Get info about a user id or username, posts_type, posts_count
get_viewer Get info about the authenticated user None
check_server_status Check server/API status & authentication None

🏗️ Project Structure

product-hunt-mcp/
├── src/
│   └── product_hunt_mcp/ # Main package directory
│       ├── __init__.py
│       ├── cli.py        # Command-line entry point
│       ├── api/          # API clients & queries
│       ├── schemas/      # Data validation schemas
│       ├── tools/        # MCP tool definitions
│       └── utils/        # Utility functions
├── pyproject.toml      # Project metadata, dependencies, build config
├── README.md
├── CONTRIBUTING.md
├── CHANGELOG.md
├── Dockerfile
└── ... (config files, etc.)

🔄 Rate Limiting

The Product Hunt API has rate limits that this client respects. If you encounter rate limit errors, the client will inform you when the rate limit resets. You can check your current rate limit status using the get_api_rate_limits or check_server_status tools.


🐛 Troubleshooting

  • Missing token: Ensure your PRODUCT_HUNT_TOKEN is correctly set as an environment variable.
  • Connection issues: Verify your internet connection and that the Product Hunt API is accessible.
  • Rate limiting: If you hit rate limits, wait until the reset time or reduce your query frequency.
  • Claude Desktop/Cursor not finding the server: Verify the path to your Python executable and restart the client.

🤝 Contributing

  • PRs and issues welcome!
  • Please follow PEP8 and use ruff for linting.
  • See pyproject.toml for dev dependencies.

🌐 Links


📝 Notes

  • This project is not affiliated with Product Hunt.
  • The Product Hunt API is subject to change.

📜 License

MIT

Star History

Star History Chart

Repository Owner

jaipandya
jaipandya

User

Repository Details

Language Python
Default Branch main
Size 110 KB
Contributors 1
MCP Verified Nov 11, 2025

Programming Languages

Python
98.5%
Dockerfile
1.5%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Docker Hub MCP Server

    Docker Hub MCP Server

    Expose Docker Hub APIs to LLMs via the Model Context Protocol.

    The Docker Hub MCP Server implements the Model Context Protocol (MCP) to make Docker Hub APIs accessible to large language models, enabling AI-powered discovery and management of container images and repositories. It provides an interface for LLMs to access real-time Docker Hub data, recommend images, and streamline developer workflows. The server supports both public and private repositories through configurable authentication, and can be integrated with AI assistants like Gordon and clients such as Claude Desktop.

    • 83
    • MCP
    • docker/hub-mcp
  • Aiven MCP Server

    Aiven MCP Server

    Model Context Protocol server enabling LLMs to access and manage Aiven cloud data services.

    Aiven MCP Server implements the Model Context Protocol (MCP) to provide secure access to Aiven's PostgreSQL, Kafka, ClickHouse, Valkey, and OpenSearch services. It enables Large Language Models (LLMs) to seamlessly integrate and interact with these cloud data platforms, supporting full stack solution development. The server offers streamlined tools for project and service management via standardized APIs and supports integration with platforms like Claude Desktop and Cursor. Environment variable configuration and explicit permission controls are used to ensure secure and flexible operations.

    • 11
    • MCP
    • Aiven-Open/mcp-aiven
  • MCP Server for Milvus

    MCP Server for Milvus

    Bridge Milvus vector database with AI apps using Model Context Protocol (MCP).

    MCP Server for Milvus enables seamless integration between the Milvus vector database and large language model (LLM) applications via the Model Context Protocol. It exposes Milvus functionality to external LLM-powered tools through both stdio and Server-Sent Events communication modes. The solution is compatible with MCP-enabled clients such as Claude Desktop and Cursor, supporting easy access to relevant vector data for enhanced AI workflows. Configuration is flexible through environment variables or command-line arguments.

    • 196
    • MCP
    • zilliztech/mcp-server-milvus
  • Dappier MCP Server

    Dappier MCP Server

    Real-time web search and premium data access for AI agents via Model Context Protocol.

    Dappier MCP Server enables fast, real-time web search and access to premium data sources, including news, financial markets, sports, and weather, for AI agents using the Model Context Protocol (MCP). It integrates seamlessly with tools like Claude Desktop and Cursor, allowing users to enhance their AI workflows with up-to-date, trusted information. Simple installation and configuration are provided for multiple platforms, leveraging API keys for secure access. The solution supports deployment via Smithery and direct installation with 'uv', facilitating rapid setup for developers.

    • 35
    • MCP
    • DappierAI/dappier-mcp
  • MCP Server for Iaptic

    MCP Server for Iaptic

    A Model Context Protocol server for accessing and managing Iaptic data with AI agents.

    MCP Server for Iaptic implements the Model Context Protocol to enable AI models, such as Claude, to securely and efficiently interact with Iaptic's customer, purchase, transaction, and statistics data. The server provides a standardized interface and command set for querying and managing information related to customers, purchases, transactions, events, and application management. Designed for integration with Claude Desktop and similar AI clients, it offers both automated and manual installation options.

    • 5
    • MCP
    • iaptic/mcp-server-iaptic
  • @dealx/mcp-server

    @dealx/mcp-server

    MCP server enabling LLMs to search and interact with the DealX platform.

    Implements the Model Context Protocol, providing a standardized interface for large language models to interact with the DealX platform. Supports searching for ads through structured prompts and is designed for easy integration with tools like Claude and VS Code extensions. Flexible configuration options are available for environment variables, logging, and deployment. Extensible architecture supports future feature additions beyond ad search.

    • 0
    • MCP
    • DealExpress/mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results