Practical overview
When it fits
Use it before writing code for a new app or startup concept, especially when you want to compare existing projects and developer discussion before choosing a direction.
Who it is for
- Builders who want a source-based competitor scan before starting a project.
- AI-agent users who want idea research available as an MCP tool.
- Developers who prefer to submit an idea through the documented REST API.
Documented uses
- Check whether similar developer tools or projects already appear in public sources.
- Compare a quick scan with a broader scan that includes package registries and Stack Overflow.
- Use source evidence and trend signals to inform whether to build, pivot or reconsider an idea.
Requirements & limits
The repository describes the project as free and MIT-licensed, and documents both local MCP setup and a hosted REST API that requires no API key. It lists Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Smithery and Docker as supported setup options.
- Quick mode checks GitHub and Hacker News; deep mode adds npm, PyPI and Stack Overflow.
- The score is based on indexed public-source signals, so it is a research input rather than a direct measure of customer demand.
- The repository describes the project as in maintenance mode, with no new features planned.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Connect Idea Reality MCP to Claude Code
Install the MCP server and add it to Claude Code so an agent can call idea_check.
Before you start
- Claude Code
- The documented uvx command
Steps
Install the server with
uvx idea-reality-mcp.Register it with Claude Code using
claude mcp add idea-reality -- uvx idea-reality-mcp.Ask the agent to check a proposed app or startup idea before building.
Expected outcome
The agent can call idea_check and return a reality signal, competitors and pivot suggestions.
Guide limitations
- The quick-start documents the MCP tool flow; it does not specify how to interpret the score as a business decision.
Request a quick or deep check through the REST API
Submit an idea to the hosted API and choose the documented research depth.
Before you start
- A command-line environment with curl
- The hosted API address documented in the repository
Steps
Send a POST request to
https://idea-reality-mcp.onrender.com/api/checkwith a JSON body containingidea_textanddepth.Choose
quickfor GitHub and Hacker News, ordeepto add npm, PyPI and Stack Overflow.Review the returned reality signal and evidence.
Expected outcome
A JSON research response for the submitted idea, without requiring an MCP client.
Guide limitations
- The documented REST example requires no API key; the repository does not describe the API response as a comprehensive measure of customer demand.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 12 October 2026
- Original website title
- mnemox-ai/idea-reality-mcp · Official homepage title · retained in its source language

