PromptBranch MCP server
io.github.PromptBranch/promptbranch·v0.2.6·9 starsLocal-first MCP server for versioning, searching, evaluating, and improving AI prompts.
9 stars54 downloads/wk
Reviews
Write oneNobody has reviewed PromptBranch yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
PromptBranch tools (6, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_noteAttach a freeform note to a prompt (or a specific version of it).
get_promptFetch and render a prompt. If status is needs_input, do not execute content: ask the user for every missingVariables value, then call get_prompt again with variables. Execute content only when status is ready. Defaults to the current (preferred) version; pin with version and/or branch.
list_promptsList prompts in the library, optionally filtered by collection or tag.
report_runwrite actionReport that a prompt version was used: which tool/model ran it, the outcome rating (1\u20135) and a short result summary.
search_promptsFull-text search over prompt titles, descriptions, tags, notes and version content.
suggest_variationPropose a rewritten version of a prompt. Creates a PENDING suggestion that a human must approve in the PromptBranch app before it becomes usable \u2014 agents propose, humans approve.
Public scan report
scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 18 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- mediumeval / new Function used
exec.evaldist/index.js: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
How PromptBranch compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,243 servers
- Tools
- 6
- the typical server has 7
- Tools that change things
- 17%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 9
- more than 87% of 28,706 servers
- Downloads a week
- 54
- more than 43% of 12,306 servers with a package
What its tools let an agent do: 4 read · 1 create · 1 change
Install PromptBranch in Claude Code, Cursor or VS Code
Runs npx -y @promptbranch/mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add promptbranch -- npx -y @promptbranch/mcp
What the publisher says
From the PromptBranch repository's README, as published. We do not edit it. Read it on GitHub
PromptBranch
A local-first prompt library and version-control system for AI prompts.
Features · Install · Docs · GitHub
PromptBranch is a simple, local-first place to create, organize, test, and improve your AI prompts. Keep prompts on your own computer, track their changes over time, run them with different AI models, and connect your favorite AI tools. You stay in control of your data and approve changes before they are saved.
[!WARNING]
Work in progress. PromptBranch is actively evolving. You may encounter bugs or
incomplete behavior, and features may change as development continues.
Please report non-security issues.
Report security concerns privately through the security policy.
Features
Build a prompt library
search (⌘K), History and Notes, JSON import/export, and automatic local backups.
- 📚 Organize prompts with tags, collections, starring, filters, full-text
optional Quick access palette, a configurable global shortcut, variable inputs, and an exact text preview.
- 📋 Copy prompts from another app while PromptBranch is running with the
save-as-new actions, history labels, change notes, diffs, and variations.
- 🌿 Track versions with branches, stable version IDs, amend-in-place and
side-by-side comparison, an LLM judge, and an evaluation summary.
- 🧪 Evaluate results with four-dimension ratings, a Results run log,
Run with AI and agents
catalog for OpenAI, Anthropic, Google, and OpenAI-compatible endpoints. Run up to six models concurrently with encrypted API keys and token/cost tracking.
- ⚡ Run against multiple models using a models.dev-backed
can report runs and notes or propose variations; humans review and approve them.
- 🤖 Work with agents through a CLI and MCP server over the same library. Agents
Share and sync on your terms
scanning, import deep links, revocable delete tokens, and a dedicated Shares view.
- 🔗 Share immutable snapshots behind unguessable URLs, with pre-publish secret
verified code; changes are stored locally first and catch up automatically when devices can reach one another.
- 🔄 Sync directly between your devices on the local network. Pair with a short
Installation
PromptBranch desktop is available for macOS, Windows, and Linux. Download an installer for your operating system from GitHub Releases.
The CLI and MCP server are cross-platform too. See the installation guide for setup, including building from source.
Where your data lives
The desktop app, CLI and MCP server all open the same database:
Set PROMPTBRANCHDB=/path/to.db to point any entry point at a different library (for example, a separate personal or test library). If you used a pre-release build (named PromptBuilder or PromptHub*), the app copies your existing library into the new location on first launch and leaves the original untouched.
It is safe to run the CLI or MCP server while the desktop app is open — they share the database file. The app picks up new runs, notes, ratings and suggestions when you focus the window.
Agent integration
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
PromptBranch: common questions
- Is PromptBranch MCP server safe?
- Mostly: it is graded B (83/100). Read the PromptBranch safety report
- How do I install PromptBranch?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does PromptBranch need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is PromptBranch maintained?
- The last commit was 38 days ago (2026-09-28). The latest release is v0.2.6.
- How does PromptBranch compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,243 servers); tools 6 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.