Skip to content
MCP server

Idea Reality MCP

Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.4
Listing updated
5 days ago

About Idea Reality MCP

Idea Reality MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add idea-reality-mcp --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env PRODUCTHUNT_TOKEN='<PRODUCTHUNT_TOKEN>' -- uvx idea-reality-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "idea-reality-mcp": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "PRODUCTHUNT_TOKEN": "<PRODUCTHUNT_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "idea-reality-mcp": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "PRODUCTHUNT_TOKEN": "<PRODUCTHUNT_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "idea-reality-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "PRODUCTHUNT_TOKEN": "<PRODUCTHUNT_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "idea-reality-mcp": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "PRODUCTHUNT_TOKEN": "<PRODUCTHUNT_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "idea-reality-mcp": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "PRODUCTHUNT_TOKEN": "<PRODUCTHUNT_TOKEN>"
      }
    }
  }
}

Configuration

  • GITHUB_TOKENGitHub PAT for higher rate limits (optional)
  • PRODUCTHUNT_TOKENProduct Hunt API token for deep mode (optional)

Pricing

Open source

Idea Reality MCP FAQ

Is Idea Reality MCP free?

Yes. Idea Reality MCP is open source, so you can use and self-host it for free.

How do I add Idea Reality MCP to Claude Code?

Run this command in your terminal: claude mcp add idea-reality-mcp --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env PRODUCTHUNT_TOKEN='<PRODUCTHUNT_TOKEN>' -- uvx idea-reality-mcp