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:
terminalcurl "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: …
~JustBuildApps