🚀 Product Hunt MCP Server
A plug-and-play MCP server for Product Hunt
📦 Quick Install
🏃♂️ Quick Start Example
✨ 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 ashttps://localhost:8424/callback
.
Installation
Preferred: uv (fast, modern Python installer)
Install from PyPI (recommended)
Install from GitHub (latest main branch)
Install locally from source
🚀 Usage with Claude Desktop & Cursor
Once installed, the product-hunt-mcp
command will be available. Add it to your Claude Desktop or Cursor configuration:
- 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:CopyUse 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:
For Claude Desktop/Cursor integration with Docker, use this configuration:
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
🔄 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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
product-hunt-mcp
Related MCP Servers
- JavaScriptMIT License
- TypeScriptGPL 3.0
- GoMIT License
- PythonMIT License