Labsco
mnemox-ai logo

idea-reality-mcp

β˜… 748

from mnemox-ai

Pre-build reality check for AI agents. Scans GitHub, HN, npm, PyPI & Product Hunt β€” returns a 0-100 signal.

πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeNeeds API keys
#email#automation#database#devops#git#maps#news#design

English | 繁體中文

idea-reality-mcp

How to check if someone already built your app idea β€” automatically.

idea-reality-mcp is an MCP server that scans GitHub, npm, PyPI, Hacker News, Product Hunt, and Stack Overflow to check if your startup idea already exists. It returns a 0–100 reality score with evidence, trend detection, and pivot suggestions β€” so your AI agent can decide whether to build, pivot, or kill the idea before writing any code.

When to use this: You're about to start a new project and want to know if similar tools already exist, how competitive the space is, and whether the market is growing or declining.

How it works

  • Describe your idea in plain English β€” e.g. "a CLI tool that converts Figma designs to React components"

  • idea_check scans 6 databases in parallel (GitHub repos + stars, Hacker News discussions, npm/PyPI packages, Product Hunt launches, Stack Overflow questions)

  • Get a 0–100 reality score with trend direction (accelerating/stable/declining), top competitors, and AI-generated pivot suggestions

What you get

Copy & paste β€” that's it
You: "AI code review tool"

idea_check β†’
β”œβ”€β”€ reality_signal: 92/100
β”œβ”€β”€ trend: accelerating β†—
β”œβ”€β”€ market_momentum: 73/100
β”œβ”€β”€ GitHub repos: 847 (45% created in last 6 months)
β”œβ”€β”€ Top competitor: reviewdog (9,094 ⭐)
β”œβ”€β”€ npm packages: 56
β”œβ”€β”€ HN discussions: 254 (trending up)
└── Verdict: HIGH β€” market is accelerating, find a niche fast

One score. Six sources. Trend detection. Your agent decides what to do next.

Try it in your browser β€” no install

Why not just Google it?

Your AI agent never Googles anything before it starts building. idea_check runs inside your agent β€” it triggers automatically whether you remember or not.

Google ChatGPT idea-reality-mcp Who runs it You, manually You, manually Your agent, automatically Output 10 blue links "Sounds promising!" Score 0-100 + evidence Sources Web pages None (LLM) GitHub + HN + npm + PyPI + PH + SO Price Free Paywall Free & open-source (MIT)

Modes

Mode Sources Use case quick (default) GitHub + HN Fast sanity check, < 3 seconds deep GitHub + HN + npm + PyPI + Product Hunt + Stack Overflow Full competitive scan

Scoring weights

Source Quick Deep GitHub repos 60% 22% GitHub stars 20% 9% Hacker News 20% 14% npm β€” 18% PyPI β€” 13% Product Hunt β€” 14% Stack Overflow β€” 10%

If a source is unavailable, its weight is redistributed automatically.

Tool schema

idea_check

Parameter Type Required Description idea_text string yes Natural-language description of idea depth "quick" | "deep" no "quick" = GitHub + HN (default). "deep" = all 6 sources

Full output example

Copy & paste β€” that's it
{
 "reality_signal": 72,
 "duplicate_likelihood": "high",
 "trend": "accelerating",
 "sub_scores": { "market_momentum": 73 },
 "evidence": [
 {"source": "github", "type": "repo_count", "query": "...", "count": 342},
 {"source": "github", "type": "max_stars", "query": "...", "count": 15000},
 {"source": "hackernews", "type": "mention_count", "query": "...", "count": 18},
 {"source": "npm", "type": "package_count", "query": "...", "count": 56},
 {"source": "pypi", "type": "package_count", "query": "...", "count": 23},
 {"source": "producthunt", "type": "product_count", "query": "...", "count": 8},
 {"source": "stackoverflow", "type": "question_count", "query": "...", "count": 120}
 ],
 "top_similars": [
 {"name": "user/repo", "url": "https://github.com/...", "stars": 15000, "description": "..."}
 ],
 "pivot_hints": [
 "High competition. Consider a niche differentiator...",
 "The leading project may have gaps in..."
 ]
}

CI: Auto-check on Pull Requests

Use idea-check-action to validate feature proposals:

Copy & paste β€” that's it
name: Idea Reality Check
on:
 issues:
 types: [opened]

jobs:
 check:
 if: contains(github.event.issue.labels.*.name, 'proposal')
 runs-on: ubuntu-latest
 steps:
 - uses: mnemox-ai/idea-check-action@v1
 with:
 idea: ${{ github.event.issue.title }}
 github-token: ${{ secrets.GITHUB_TOKEN }}

Optional config

Copy & paste β€” that's it
export GITHUB_TOKEN=ghp_... # Higher GitHub API rate limits
export PRODUCTHUNT_TOKEN=your_... # Enable Product Hunt (deep mode)

Auto-trigger: Add one line to your CLAUDE.md, .cursorrules, or .github/copilot-instructions.md:

Copy & paste β€” that's it
When starting a new project, use the idea_check MCP tool to check if similar projects already exist.

Roadmap

  • v0.1 β€” GitHub + HN search, basic scoring

  • v0.2 β€” Deep mode (npm, PyPI, Product Hunt), keyword extraction

  • v0.3 β€” 3-stage keyword pipeline, Chinese term mappings, LLM-powered search

  • v0.4 β€” Score History, Agent Templates, GitHub Action

  • v0.5 β€” Temporal signals, trend detection, market momentum

  • v0.6 β€” Onboarding CLI (idea-reality setup, config, doctor)

  • v1.0 β€” Idea Memory Dataset (opt-in anonymous logging)

Star History

Found a blind spot?

If the tool missed obvious competitors or returned irrelevant results:

  • Open an issue with your idea text and the output

  • We'll improve the keyword extraction for your domain

Contributing

See CONTRIBUTING.md (繁體中文).

License

MIT β€” see LICENSE

Built by Mnemox AI Β· [emailΒ protected]