Product Hunt MCP Server
Plug-and-play MCP server for accessing Product Hunt data with LLMs and agents.
Key Features
Use Cases
README
🚀 Product Hunt MCP Server
A plug-and-play MCP server for Product Hunt
📦 Quick Install
pip install product-hunt-mcp
🏃♂️ Quick Start Example
# 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 Tokenfor 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 ashttps://localhost:8424/callback.
Installation
Preferred: uv (fast, modern Python installer)
# Install uv if you don't have it
pip install uv
Install from PyPI (recommended)
uv pip install product-hunt-mcp
# or
pip install product-hunt-mcp
Install from GitHub (latest main branch)
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
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:
{
"mcpServers": {
"product-hunt": {
"command": "product-hunt-mcp",
"env": {
"PRODUCT_HUNT_TOKEN": "your_token_here"
}
}
}
}
- Replace
your_token_herewith 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-mcpcommand if it's not in the default PATH. If you encounter issues, you can provide the full path to the executable. After installing, run:bashwhich product-hunt-mcpUse 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
- Windows:
-
Cursor:
- Windows:
%APPDATA%\Cursor\User\settings.json - macOS:
~/Library/Application Support/Cursor/User/settings.json - Linux:
~/.config/Cursor/User/settings.json
- Windows:
Docker
You can also run the server using Docker:
# 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:
{
"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_TOKENis 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_TOKENis 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.tomlfor dev dependencies.
🌐 Links
📝 Notes
- This project is not affiliated with Product Hunt.
- The Product Hunt API is subject to change.
📜 License
MIT
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
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
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
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
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
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
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?