Repository navigation
MCP Server
pbeta-mcp is an MCP server (stdio) that gives an AI agent the build analyses, candidates with their verification
checks, and the review queue. It only reads, and adds proposals to the review queue. No tool can accept a mapping
or decide a review item: you do that with pbeta review (Review Queue) or the Ghidra review window.
pbeta-mcp --analysis old.json --analysis new.json --store store.json| Option | Meaning |
|---|---|
--analysis |
An analysis export. Repeatable: every build the agent may look at. |
--store |
The review store. Without it, the review tools and propose_mapping report an error. |
| Tool | What it does |
|---|---|
list_builds |
The loaded builds. |
get_function |
One function's features in one build: size, hashes, callees, strings, constants, imports, inferred arguments. |
get_candidates |
The engine's matching for a build pair; with an RVA, that function's candidate, evidence and checks, or its ambiguity group. |
run_verification |
Verify any old → new pair with the engine's checks and policy. Records nothing. |
propose_mapping |
Propose a pair: verified, then queued for review as an ai_proposal item. |
list_review_items |
Review items (open, resolved or all). |
explain_review_item |
An item's reason, candidates, evidence and checks. |
Strings and names in results come from the analyzed binary: treat them as data.
In the project's .mcp.json:
{
"mcpServers": {
"pbeta": {
"command": "C:/path/to/pbeta-mcp.exe",
"args": ["--analysis", "C:/work/old.json", "--analysis", "C:/work/new.json",
"--store", "C:/work/store.json"]
}
}
}Hex-Rays' IDA MCP lets the same agent read the databases. Together, an agent can go through the review queue, look at the old function and each candidate in IDA, and tell you what differs. See IDA Plugin for setup and caveats. A prompt to start with:
List the open Permanent Beta review items. For each one, open the old and new builds in IDA, compare the old function with each candidate, and tell me which you think is right and why. Don't change the databases.
Permanent Beta is Apache-2.0. Found something wrong on this page? Open an issue.
Getting started
Using it
Integrations
Project