skills.rest
reason-machines
reason-machinesOFFICIAL
Explore all skills by this author →
Website𝕏@reasonmachinesGitHub

idea-reality-mcp-validation

Validates project ideas by scanning GitHub, Hacker News, npm, PyPI, Product Hunt, and Stack Overflow.

7|2|Updated May 16, 2026
Search Tags:#github#idea validation#market research#competitor analysis#MCP server#Product Hunt#trend detection
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill idea-reality-mcp-validation-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: idea-reality-mcp-validation
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/idea-reality-mcp-validation
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill idea-reality-mcp-validation-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often spend weeks building tools or products only to discover that similar solutions already exist or the market is saturated. This Skill runs a pre-build reality check across six public data sources so you can assess competition and market momentum before writing any code. ## Core Features & Use Cases - Reality Score (0-100): The idea_check MCP tool returns a numeric competition score, duplicate likelihood, and trend direction (accelerating, stable, or declining). - Two Scan Depths: Quick mode checks GitHub and Hacker News in under 3 seconds; deep mode adds npm, PyPI, Product Hunt, and Stack Overflow. - Competitor and Pivot Insights: Responses include top similar projects with star counts plus pivot hints suggesting niche differentiators. - Use Case: Before scaffolding a new CLI tool, ask your agent to run a deep idea check; if the reality signal exceeds 80, review the top competitors and pivot hints instead of building a duplicate. ## Quick Start Ask your AI agent to run a reality check on your project idea, for example: check if a CLI tool that converts Figma designs to React components already exists using deep mode.

Frequently Asked Questions about idea-reality-mcp-validation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my project idea already exists?▼

Call the idea_check MCP tool with a natural-language idea_text description and a depth of quick or deep. It returns a 0-100 reality signal, duplicate likelihood, top similar projects, and pivot suggestions based on six data sources.

What is the difference between quick and deep mode in idea_check?▼

Quick mode scans only GitHub and Hacker News and finishes in under 3 seconds. Deep mode scans all six sources including npm, PyPI, Product Hunt, and Stack Overflow, taking roughly 10-15 seconds for broader coverage.

How do I install idea-reality-mcp in Claude Code or Cursor?▼

Run claude mcp add idea-reality -- uvx idea-reality-mcp for Claude Code, or add a uvx command entry to your Cursor or Claude Desktop MCP config JSON. The idea-reality setup wizard can also generate the config automatically.

Why does idea_check hit GitHub API rate limits?▼

Unauthenticated GitHub API requests have low rate limits, which larger scans can exceed. Set the GITHUB_TOKEN environment variable with a personal access token (no scopes needed for public data) and verify with idea-reality doctor --full.

Can I use idea-reality-mcp without an MCP client?▼

Yes, a public REST API is available at the hosted endpoint via POST requests with idea_text and depth in the JSON body. Python httpx and cURL examples are provided, and a GitHub Action can auto-validate issues labeled proposal.

What do the reality signal scores mean?▼

Scores 0-30 indicate low competition and a potentially novel idea, 31-60 suggest moderate competition requiring a unique angle, 61-85 mean high competition needing niche differentiation, and 86-100 indicate a saturated market where a pivot is recommended.

Related Skills

Explore More Product & Management Skills→
elysiaericaelysiaerica

content-idea-generator

Generate content ideas for platforms using Python text analysis and search APIs.

Community
Intermediate
vp-kvp-k

Competitive Frame

Extract features from source code and compare them against competitors.

Community
Intermediate
simplefarmer69simplefarmer69
2

dataforseo-cli

Retrieve keyword metrics and competitor ranking data via the DataForSEO API in TSV format.

Community
Intermediate
NirusanNirusan
7

content-strategy

Develop content plans by mapping topic clusters and prioritizing ideas.

Community
Advanced