Skip to content

MCP Server

Ryan Cole edited this page Nov 14, 2026 · 1 revision

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.

Run

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.

Tools

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.

Claude Code

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"]
    }
  }
}

With IDA MCP

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.

Clone this wiki locally