← Back to directory
I

Idea Reality MCP

Community
Automatically check if someone already built your app idea before you write code.
Category
Dev Tools #147 of 438
Stars
★ 825 Very popular
Transport
stdio (local process)
Runtime
Python
Credentials
Optional API key
License
MIT
Last commit
Tools
1
58FMRS · C

This server fulfills the need for quick idea validation, but users should understand the limitations of its data sources and terms of use.

Strongest · Maintenance 15/20 Weakest · Reliability 9/20

Reliability
9/20
Security and permissions
12/20
Maintenance
15/20
Documentation
12/20
Setup experience
10/20
Why each score
Reliability 9/20
Source code indicates the implementation of idea_check core logic, but no full test suite or CI workflow visible in provided files, so clean startup and tool-list handshake are not verifiable. Score reduced due to lack of execution evidence.
Security and permissions 12/20
Main risks are optional GITHUB_TOKEN (secret) and network calls to GitHub and other sources; no hardcoded secrets or dangerous operations without confirmation observed. Minimal privilege not clearly demonstrated, but no red line crossed, so moderate-high score.
Maintenance 15/20
Repository active: 774 stars, 3 open issues, not archived, MIT license, version 0.5.0, and roadmap updates; good maintenance but no explicit security response channel, so slight deduction.
Documentation 12/20
README provides detailed installation, configuration, usage, scoring weights, and output examples; documentation is comprehensive but lacks explicit troubleshooting and limitations (e.g., API dependencies), so deduction.
Setup experience 10/20
Install command clear (uvx idea-reality-mcp) with config examples for multiple clients; however optional GITHUB_TOKEN setup and no CI/test evidence mean setup cannot be fully verified as seamless, so score limited.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers
  • Indie hackers
  • AI coding agents

Not for

  • Users needing real-time or exhaustive market data
  • Users who don't consent to automated data collection

Required permissions

  • Network access to query external APIs
  • Optional: GITHUB_TOKEN for higher rate limits

Risks and side effects

  • Results are based on public data and may be incomplete
  • Quick mode only checks GitHub and HN, may miss other platforms

Setup

Before you start

Runtime:Python

GITHUB_TOKEN optionalsecret Optional GitHub Personal Access Token used to raise GitHub API rate limits; create one in GitHub's Developer settings.
  1. Install: uvx idea-reality-mcp
  2. Add to your agent: claude mcp add idea-reality -- uvx idea-reality-mcp
  3. Ask your agent to check an idea.
claude_desktop_config.json
{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add idea-reality -- uvx idea-reality-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

The idea_check tool should appear in your client's tool list; you can also ask your agent 'Before I start building, check if this already exists: a CLI tool that converts Figma designs to React components' — a response containing reality_signal and competitor evidence confirms the connection.

Troubleshooting

  1. Ensure network connectivity
  2. Check GITHUB_TOKEN validity
  3. Try deep mode for more comprehensive results

Things to try

Once connected, you can ask your AI assistant things like:

  • Before I start building, check if this already exists: a CLI tool that converts Figma designs to React components.
  • Run idea_check in deep mode on 'AI code review tool' and give me the 0-100 reality score with top competitors.
  • Do a quick check for 'a Markdown notes tool that auto-publishes to a blog' and tell me whether the trend is accelerating or declining.
  • Check my idea 'a local-first RSS reader' across GitHub, HN, npm, PyPI and Stack Overflow, and give me pivot suggestions.

Tools 1

idea_check read-only
Performs a reality check on a given idea text, returning a 0-100 reality signal, competitive landscape, trend direction, and suggestions.

Use cases

Check market before starting a new project
Avoid reinventing the wheel
Get pivot or differentiation suggestions

Supported clients

Claude Desktop
Claude Code
Cursor

Listed from the project's documentation, not tested by this site.

Overview

idea-reality-mcp is an MCP server that scans GitHub, npm, PyPI, Hacker News, and Stack Overflow to return a 0-100 reality score with evidence, trend detection, and pivot suggestions. It helps AI agents decide whether to build, pivot, or kill an idea without manual searching.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →

Source revision 83281b4cf7b6 Data synced 2026-10-19 Read the FMRS scoring method