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 - Get detailed info on posts, comments, collections, topics, users - Search/filter b
Add this skill
npx mdskills install jaipandya/producthunt-mcp-serverComprehensive Product Hunt MCP server with well-documented tools, clear setup instructions, and Docker support
1# 🚀 Product Hunt MCP Server23[](https://pypi.org/project/product-hunt-mcp/)4[](LICENSE)5[](https://www.python.org/)6[](Dockerfile)7[](https://modelcontextprotocol.io/)89> **A plug-and-play [MCP](https://modelcontextprotocol.io/) server for Product Hunt**1011---1213## 📦 Quick Install1415```bash16pip install product-hunt-mcp17```1819## 🏃♂️ Quick Start Example2021```bash22# Run the MCP server (requires PRODUCT_HUNT_TOKEN environment variable)23export PRODUCT_HUNT_TOKEN=your_token_here24product-hunt-mcp25```2627---2829## ✨ What is this?3031**Product Hunt MCP Server** connects Product Hunt's API to any LLM or agent that speaks the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Perfect for AI assistants, chatbots, or your own automations!3233- 🔍 Get posts, collections, topics, users34- 🗳️ Get votes, comments, and more35- 🛠️ Use with Claude Desktop, Cursor, or any MCP client3637---3839## 🛠️ Features4041- Get detailed info on posts, comments, collections, topics, users42- Search/filter by topic, date, votes, etc.43- Paginated comments, user upvotes, and more44- Built with [FastMCP](https://github.com/jlowin/fastmcp) for speed and compatibility4546---4748## 🧑💻 Who is this for?4950- **AI/LLM users**: Plug into Claude Desktop, Cursor, or your own agent51- **Developers**: Build bots, dashboards, or automations with Product Hunt data52- **Tinkerers**: Explore the MCP ecosystem and build your own tools5354---5556## 🏁 Setup5758### Prerequisites5960- Python 3.10+61- Product Hunt API token ([get one here](https://www.producthunt.com/v2/oauth/applications))62 - You'll need to create an account on Product Hunt63 - Navigate to the API Dashboard and create a new application64 - Use the `Developer Token` for the token6566> **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`.6768### Installation6970**Preferred: [uv](https://github.com/astral-sh/uv) (fast, modern Python installer)**7172```bash73# Install uv if you don't have it74pip install uv75```7677#### Install from PyPI (recommended)78```bash79uv pip install product-hunt-mcp80# or81pip install product-hunt-mcp82```8384#### Install from GitHub (latest main branch)85```bash86uv pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'87# or88pip install 'git+https://github.com/jaipandya/producthunt-mcp-server.git'89```9091#### Install locally from source92```bash93uv pip install .94# or95pip install .96```9798---99100## 🚀 Usage with Claude Desktop & Cursor101102Once installed, the `product-hunt-mcp` command will be available. Add it to your Claude Desktop or Cursor configuration:103104```json105{106 "mcpServers": {107 "product-hunt": {108 "command": "product-hunt-mcp",109 "env": {110 "PRODUCT_HUNT_TOKEN": "your_token_here"111 }112 }113 }114}115```116117- Replace `your_token_here` with your actual Product Hunt API token.118- The token **must** be set as an environment variable in your Claude Desktop or Cursor config for the server to authenticate.119- Always restart your client (Claude Desktop/Cursor) after editing the config file.120121> **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:122>123> ```bash124> which product-hunt-mcp125> ```126>127> 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"`).128129### Finding your configuration file130131- **Claude Desktop**:132 - Windows: `%APPDATA%\claude-desktop\config.json`133 - macOS: `~/Library/Application Support/claude-desktop/config.json`134 - Linux: `~/.config/claude-desktop/config.json`135136- **Cursor**:137 - Windows: `%APPDATA%\Cursor\User\settings.json`138 - macOS: `~/Library/Application Support/Cursor/User/settings.json`139 - Linux: `~/.config/Cursor/User/settings.json`140141### Docker142143You can also run the server using Docker:144145```bash146# Build the Docker image147docker build -t product-hunt-mcp .148149# Run the Docker container (interactive for MCP)150docker run -i --rm -e PRODUCT_HUNT_TOKEN=your_token_here product-hunt-mcp151```152153For Claude Desktop/Cursor integration with Docker, use this configuration:154155```json156{157 "mcpServers": {158 "product-hunt": {159 "command": "docker",160 "args": ["run", "-i", "--rm", "-e", "PRODUCT_HUNT_TOKEN=your_token_here", "product-hunt-mcp"],161 "env": {}162 }163 }164}165```166167> **Security Note:** Your `PRODUCT_HUNT_TOKEN` is sensitive. Do not share it or commit it to version control.168169---170171## 🛠️ MCP Tools172173| Tool | Description | Key Parameters |174|---------------------|---------------------------------------------|----------------|175| get_post_details | Get info about a specific post | `id` or `slug`, `comments_count`, `comments_after` |176| get_posts | Get posts with filters | `topic`, `order`, `count`, `featured`, `posted_before`, `posted_after` |177| get_comment | Get info about a specific comment | `id` (required) |178| get_post_comments | Get comments for a post | `post_id` or `slug`, `order`, `count`, `after` |179| get_collection | Get info about a collection | `id` or `slug` |180| get_collections | Get collections with filters | `featured`, `user_id`, `post_id`, `order`, `count` |181| get_topic | Get info about a topic | `id` or `slug` |182| search_topics | Search topics | `query`, `followed_by_user_id`, `order`, `count` |183| get_user | Get info about a user | `id` or `username`, `posts_type`, `posts_count` |184| get_viewer | Get info about the authenticated user | None |185| check_server_status | Check server/API status & authentication | None |186187---188189## 🏗️ Project Structure190191```192product-hunt-mcp/193├── src/194│ └── product_hunt_mcp/ # Main package directory195│ ├── __init__.py196│ ├── cli.py # Command-line entry point197│ ├── api/ # API clients & queries198│ ├── schemas/ # Data validation schemas199│ ├── tools/ # MCP tool definitions200│ └── utils/ # Utility functions201├── pyproject.toml # Project metadata, dependencies, build config202├── README.md203├── CONTRIBUTING.md204├── CHANGELOG.md205├── Dockerfile206└── ... (config files, etc.)207```208209---210211## 🔄 Rate Limiting212213The 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.214215---216217## 🐛 Troubleshooting218219- **Missing token**: Ensure your `PRODUCT_HUNT_TOKEN` is correctly set as an environment variable.220- **Connection issues**: Verify your internet connection and that the Product Hunt API is accessible.221- **Rate limiting**: If you hit rate limits, wait until the reset time or reduce your query frequency.222- **Claude Desktop/Cursor not finding the server**: Verify the path to your Python executable and restart the client.223224---225226## 🤝 Contributing227228- PRs and issues welcome!229- Please follow [PEP8](https://peps.python.org/pep-0008/) and use [ruff](https://github.com/charliermarsh/ruff) for linting.230- See `pyproject.toml` for dev dependencies.231232---233234## 🌐 Links235236- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)237- [FastMCP](https://github.com/jlowin/fastmcp)238- [Product Hunt API Docs](https://www.producthunt.com/v2/docs)239- [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector)240- [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)241242---243244## 📝 Notes245246- This project is not affiliated with Product Hunt.247- The Product Hunt API is subject to change.248249---250251## 📜 License252253MIT
Full transparency — inspect the skill content before installing.