Model Context Protocol

JustBuildApps MCP Server

Give your AI agent semantic search over 800+ curated indie apps. One config snippet, no API key for search.

Option A — Local (recommended)

Runs on your machine via uvx (needs uv). Paste into your MCP client config:

mcp.json
{
  "mcpServers": {
    "justbuildapps": {
      "command": "uvx",
      "args": ["justbuildapps-mcp"]
    }
  }
}

Where the config lives

  • Claude Desktop — claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS)
  • Cursor — .muse/mcp.json (project) or ~/.muse/mcp.json (global)
  • VS Code — .vscode/mcp.json
  • Windsurf — ~/.codeium/windsurf/mcp_config.json

Option B — Hosted remote (zero install)

Point any Streamable HTTP-capable client at our hosted endpoint:

https://api.justbuildapps.com/mcp
{
  "mcpServers": {
    "justbuildapps": {
      "type": "streamable-http",
      "url": "https://api.justbuildapps.com/mcp"
    }
  }
}

Same 16 tools, same data — we host it, you just connect. Prefer local (Option A) if you want to pin a version or work offline from our infra.

16 tools, 3 resources, 2 prompts

Discovery — public, no auth

  • search_appsSemantic search by task. Ranked tools with relevance scores, demo URLs, pricing, usage guidance.
  • browse_appsBrowse/filter the catalog with sorting + pagination (pricing, audience, stars, ...).
  • get_appFull metadata for one app — capabilities, install info, docs.
  • get_similar_apps'Alternatives to X' via embedding similarity.
  • get_trendingTrending + top-rated + newest in one call.
  • verify_appHealth-check before recommending (healthy/degraded/down + reliability score).
  • list_capabilitiesEvery category/capability in the catalog.
  • get_statsCatalog statistics.

Creators & feed — public, no auth

  • get_creatorCreator profile with creations + update history.
  • search_creatorsTypeahead over handles and names.
  • get_feedCross-creator feed of launches, iterations, notes.
  • get_creationOne creation (project) with paginated updates.

Writes — public, no auth

  • submit_appSubmit an app — GitHub URL (auto-analyzed) or title + description + demo URL. Publishes immediately.
  • submit_feedbackReport broken tools, rate usefulness. Feeds the quality loop.

Writes — needs JBA_API_TOKEN

  • create_creationCreate a project under your creator profile.
  • post_updatePost a new / iteration / commentary update to an owned creation.

Resources

  • jba://apps/{app_id}
  • jba://creators/{handle}
  • jba://feed

Prompts

  • recommend — task → 2–3 vetted picks
  • alternatives — “alternatives to X”

Authenticated writes

Search, browse, verify, submit, and feedback need no auth. Only create_creation and post_update act as you — for those, mint a token at /settings/tokens and add it to your config:

mcp.json (with token)
{
  "mcpServers": {
    "justbuildapps": {
      "command": "uvx",
      "args": ["justbuildapps-mcp"],
      "env": { "JBA_API_TOKEN": "jba_..." }
    }
  }
}

Registry & source

Published on the official MCP Registry as io.github.sksareen/justbuildapps. Verify:

terminal
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=justbuildapps"

Example session

you: is there a free tool that removes backgrounds from product photos?

→ search_apps { query, cost: 'free', limit: 3 } → verify_app { app_id }

agent: PhotoRoom (verified healthy, 0.95) — free tier, no signup. open it here: …