Idea Reality Mcp

Name: Idea Reality Mcp
Author: mnemox-ai

@mnemox-ai

Repository Homepage

About Idea Reality Mcp

Pre-build reality check for AI coding agents. Scans GitHub, HN, npm, PyPI, Product Hunt. MCP server. 290+ stars.

#ai #developer-tools #reality-check #mcp #github #hackernews #npm #pypi

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ]
    }
  }
}

Tools

Check if a product idea already exists before building it. Use when users discuss new project ideas, ask about competition, market saturation, or whether something has been built before. Trigger phrases: "has anyone built", "does this exist", "check competition", "is this idea original", "有沒有人做過", "市場上有類似的嗎", "幫我查這個點子"

Overview

What is Idea Reality Mcp?

Idea Reality Mcp is an MCP (Model Context Protocol) server that automatically scans GitHub, npm, PyPI, Hacker News, Product Hunt, and Stack Overflow to check if a startup or app idea already exists. It returns a 0–100 reality score with evidence, trend detection, and pivot suggestions, allowing AI agents to decide whether to build, pivot, or abandon the idea before writing code. It is intended for developers and AI agents starting new projects.

How to use Idea Reality Mcp?

Install the server via uvx idea-reality-mcp, then add it to your MCP client. For example, in Claude Code run claude mcp add idea-reality -- uvx idea-reality-mcp. Then ask your agent: “Before I start building, check if this already exists: [your idea]”. The agent calls the idea_check tool with idea_text (required) and optional depth parameter ("quick" or "deep"). A REST API is also available at https://idea-reality-mcp.onrender.com/api/check with no API key required.

Key features of Idea Reality Mcp

Scans GitHub, Hacker News, npm, PyPI, Product Hunt, Stack Overflow.
Returns a 0–100 reality score with trend direction.
Provides top competitors, pivot suggestions, and market momentum.
Two modes: quick (GitHub + HN) and deep (all six sources).
Free and open-source (MIT license), no API key required.
Optional CI integration via GitHub Action for pull request validation.

Use cases of Idea Reality Mcp

Validate a new project idea before starting development.
Check the competitive landscape and market saturation for a concept.
Automatically detect if similar tools or packages already exist.
Decide whether to proceed, pivot, or abandon based on trend data.
Integrate into AI agent workflows to prevent building duplicate solutions.

FAQ from Idea Reality Mcp

What sources does Idea Reality Mcp scan?

In quick mode it scans GitHub repositories and Hacker News discussions. Deep mode adds npm, PyPI, Product Hunt launches, and Stack Overflow questions.

How is Idea Reality Mcp different from a manual Google search?

The server runs automatically inside your AI agent without manual effort. It returns a numerical score, evidence, and pivot suggestions rather than a list of links, and it aggregates data from six specialized sources.

Do I need an API key or authentication?

No, the basic version is free and requires no API key. For higher GitHub API rate limits you can set the GITHUB_TOKEN environment variable, and for Product Hunt deep mode you can set PRODUCTHUNT_TOKEN.

What is the reality score and how is it calculated?

The reality score is a 0–100 value derived from weighted sub-scores from each source (e.g., GitHub repos 60% in quick mode). If a source is unavailable, its weight is redistributed automatically.

What MCP clients are supported?

Idea Reality Mcp supports Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Smithery, and Docker. It can be installed via uvx or through Smithery’s remote option.