idea-reality-mcp
Pre-build reality check for AI coding agents. Scans GitHub, HN, npm, PyPI, Product Hunt. MCP server. 290+ stars.
idea-reality-mcp is an MCP server that automatically validates startup and project ideas by scanning GitHub, Hacker News, npm, PyPI, Product Hunt, and Stack Overflow. It returns a 0–100 reality score indicating whether similar projects already exist, along with trend detection, market momentum analysis, and pivot suggestions. Agents can invoke the idea_check tool before writing code to assess competition and market saturation. The server runs locally via uvx or can be accessed through a free hosted REST API.
Key Features
Use Cases
- 01Pre-build validation: check if a project idea already exists before an AI coding agent starts writing code
- 02Competitive landscape analysis: understand how crowded a niche is and identify leading projects
- 03Trend detection: determine whether a market is growing, stable, or declining based on recent activity
- 04Automated code review for feature proposals via GitHub Actions that flag duplicative ideas
- 05Agent-driven pivot recommendations when the reality score indicates high competition
- 06CI/CD integration to block low-originality feature requests before development begins
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
idea-reality-mcp — FAQ
What is idea-reality-mcp?+
idea-reality-mcp is an MCP server that scans GitHub, Hacker News, npm, PyPI, and Stack Overflow to check if your project idea already exists. It returns a reality score (0–100), trend analysis, and pivot suggestions so AI agents can make informed decisions before building.
How do I install idea-reality-mcp in Claude Desktop or Cursor?+
Run 'uvx idea-reality-mcp' to install, then add the server config to your MCP client JSON file (claude_desktop_config.json or .cursor/mcp.json). For Claude Code, use 'claude mcp add idea-reality -- uvx idea-reality-mcp' to auto-configure.
Which AI clients work with this MCP server?+
idea-reality-mcp works with Claude Desktop, Claude Code, Cursor, Windsurf, and Cline. It can also be installed remotely via Smithery or used as a REST API without any MCP client.
Do I need API keys to use idea-reality-mcp?+
No API keys are required for basic functionality. Optionally, you can set a GITHUB_TOKEN environment variable to increase GitHub API rate limits, but the tool works without it.
Is idea-reality-mcp free to use?+
Yes, idea-reality-mcp is free and open-source under the MIT license. The hosted REST API at idea-reality-mcp.onrender.com is also free to use with no authentication required.
What's the difference between quick and deep mode?+
Quick mode scans only GitHub and Hacker News and returns results in under 3 seconds. Deep mode scans all five active sources (GitHub, HN, npm, PyPI, Stack Overflow) for comprehensive competitive analysis.
How do I install idea-reality-mcp?+
Open the source repository on GitHub and follow its README. idea-reality-mcp is a mcp server — MCP Agents Market links you directly to the official repo.
Is idea-reality-mcp free?+
idea-reality-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.