BurpMCP-Ultra
The most powerful MCP server for Burp Suite Professional.
Drop a single JAR into Burp, connect Claude Code (or any MCP client), and drive every part of Burp Suite programmatically through AI agents.
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
The most powerful MCP server for Burp Suite Professional.
Drop a single JAR into Burp, connect Claude Code (or any MCP client), and drive every part of Burp Suite programmatically through AI agents.
AI-powered MCP server for Burp Suite Professional — 149 tools across proxy, scanner, inline fuzzer, race conditions, guided injection, JWT/IDOR attacks, recon & OOB, with a real-time dashboard and hardened localhost security. Drive Burp from Claude Code or any MCP client.
150 Tools • 8 Resources • 17 Event Types • Real-time Dashboard • Hardened Localhost Security
Quick Start • Tools • Features • Security • Dashboard • Setup Guides • Contact
BurpMCP-Ultra is a native Kotlin Burp Suite extension with an embedded MCP (Model Context Protocol) server. It exposes Burp's Montoya API as 150 structured tools over a token-secured local SSE transport, so an AI agent can run proxy history analysis, active scans, fuzzing, race conditions, OOB testing, custom scan checks, and guided exploitation — all from natural language.
Competitor counts are indicative, based on each project's public tool list.
git clone https://github.com/Cy-S3c/BurpMCP-Ultra.git
cd BurpMCP-Ultra
./gradlew shadowJar
Output: build/libs/burpmcp-ultra-2.3.1.jar (~13 MB). A JDK 17–21 must be installed —
see Building from Source. Pre-built JARs are on the
Releases page.
{
"mcpServers": {
"burp": {
"type": "sse",
"url": "http://127.0.0.1:9876/",
"headers": {
"Authorization": "Bearer PASTE_TOKEN_FROM_SERVER_TAB"
}
}
}
}
Add to ~/.claude.json or your project's .mcp.json.
⚠️ The token is required, and the endpoint is the root path
/— not/sse. Copy the token from the Server tab of the BurpMCP-Ultra panel in Burp. Without it the server returns401, and clients like Claude Code then fall back to OAuth discovery and fail withSDK auth failed: HTTP 404: Invalid OAuth error response.
💡 MCP client can't set headers? Use the token-in-path URL — no
headersblock needed (GitHub issue #11). Copy it with "Copy No-Headers Config" on the Server tab:{ "mcpServers": { "burp": { "type": "sse", "url": "http://127.0.0.1:9876/PASTE_TOKEN_FROM_SERVER_TAB/" } } }Keep the trailing slash — it is what makes the token survive onto the SSE back-channel. A
?token=…query does not work for MCP: the SDK advertises its POST endpoint as the relative reference?sessionId=…, which per RFC 3986 §5.3 replaces the query (so the token is dropped and every message401s) while preserving the path. Note the token becomes part of the URL, so prefer the header form when your client supports it.
Browse to http://127.0.0.1:9878 for the real-time web dashboard.
150 MCP tools across 37 categories. Names are stable; the authoritative count is
server.tools.size, surfaced in the Server tab.
Offensive tools that issue live requests are scope-gated (see Security).
Read-only MCP resources an agent can fetch without a tool call:
burp://proxy/history · burp://proxy/websocket/history · burp://scanner/issues ·
burp://sitemap · burp://scope · burp://config/project · burp://config/user ·
burp://organizer/items
injection_probe(
request: "GET /item?id=FUZZ HTTP/1.1\r\nHost: shop.com\r\n\r\n",
host: "shop.com", port: 443,
classes: ["sqli", "ssti", "lfi"] # optional; default all
)
Marks the injection point with FUZZ, then confirms vulnerabilities with deterministic
oracles — SQL error fingerprints, time-delay analysis, template math-evaluation
(1337*1337 → 1787569), and file-content markers — returning only confirmed findings with
the triggering payload. For blind/OOB classes, pair collaborator_* with http_fuzz.
jwt_attack(token: "eyJ...", mode: "crack", wordlist: ["secret", "changeme", ...])
alg:none forgery, RS→HS algorithm-confusion forging, weak-secret dictionary cracking,
and full structural analysis.
auth_diff / access_control_sweep
request: "GET /api/users/1 HTTP/1.1\r\nHost: api.com\r\n\r\n",
auth_levels: [
{"name": "admin", "header_name": "Authorization", "header_value": "Bearer admin"},
{"name": "user", "header_name": "Authorization", "header_value": "Bearer user"},
{"name": "none"}
]
Replays the same request(s) across identities, diffs the responses, and flags IDOR, privilege escalation, and missing authorization.
http_race(request: "POST /api/transfer HTTP/1.1\r\nHost: bank.com\r\n\r\n{\"amount\":100}",
host: "bank.com", port: 443, count: 20)
Fires 20 identical requests simultaneously via Burp's parallel engine and analyzes status/length distributions to detect TOCTOU, double-spend, and limit-bypass bugs.
# FUZZ keyword
http_fuzz(request: "GET /api?id=FUZZ HTTP/1.1\r\nHost: api.com\r\n\r\n", host: "api.com",
port: 443, payloads: ["1", "admin", "../../etc/passwd"])
# §section§ markers (like Intruder) | # byte offsets: positions: [[12, 15]]
# built-in payload libraries via: payload_library: "xss" | "sqli" | "lfi" | ...
# BCheck DSL
bcheck_create(name: "AWS Key Leak", type: "passive_response",
match_pattern: "AKIA[0-9A-Z]{16}", severity: "high", confidence: "firm")
# Script mode — multi-step active check
scancheck_create_active(name: "SSTI", steps: [
{"payload": "{{7*7}}", "response_conditions": [
{"location": "response_body", "pattern": "49", "condition_type": "contains"}]}])
api_import_openapi(spec_json: "<swagger/openapi JSON>", auth_header: "Authorization",
auth_value: "Bearer …", send_requests: true, add_to_sitemap: true)
Parses OpenAPI 3.x / Swagger 2.0 (resolving $ref), generates real requests with sample
parameters/bodies for every endpoint, and optionally sends them — populating proxy history
and sitemap. Out-of-scope sends are skipped and reported.
passive_intel(max_items: 2000, in_scope_only: true)
Scans captured traffic for 30+ patterns with entropy de-noising to cut false positives:
/admin, /.env, /.git, /debug, /actuatorBurpMCP-Ultra runs three local servers (SSE 9876/9877, dashboard 9878). Binding to
127.0.0.1 is not a trust boundary, so the transport is hardened and offensive tools are
governed by operator-only controls the agent cannot change.
Port already in use? PortSwigger's own MCP Server extension also defaults to 9876, so running both at once clashes. Move this extension with the
mcp_sse_port/mcp_http_port/mcp_dashboard_portpreferences (or-Dburpmcp.ssePort=…), then reload. On a clash the extension now says so explicitly in the Errors tab — it is not the JDK-version problem.
Transport hardening
Authorization: Bearer, mcp_token
cookie, ?token=, or the first URL path segment /<token>/ for header-less MCP clients).
The dashboard uses an HttpOnly cookie, so the token never lives in a URL there. A back-channel
POST ?sessionId=… may instead present a live session id — a 122-bit capability the server
discloses only over an already-authenticated stream, never a bypass.Operator governance (configured in Burp, not via MCP)
mcp_scope_mode — off / warn / enforce. Every live-request tool passes through a
central scope gate (http_*, auth_diff, api_import_openapi, recon_*, graphql_probe,
cors_probe, access_control_sweep, injection_probe).mcp_allow_destructive — default false; blocks burp_shutdown and config import.~/.burpmcp-ultra-audit.jsonl).Additional defenses: ReDoS-safe regex, CRLF header validation, and response/WebSocket size caps.
Open http://127.0.0.1:9878 for the real-time dashboard:
{
"mcpServers": {
"burp": {
"type": "sse",
"url": "http://127.0.0.1:9876/",
"headers": { "Authorization": "Bearer PASTE_TOKEN_FROM_SERVER_TAB" }
}
}
}
The token comes from the Server tab. The endpoint is the root path / (not /sse). If your
client cannot set headers, drop the headers block and put the token in the path instead —
"url": "http://127.0.0.1:9876/<token>/" (keep the trailing slash). Config locations:
~/.claude.json (global) or .mcp.json (per-project).
Caddy prevents SSE timeout disconnections and provides reliable buffering.
sudo apt install caddy
/etc/caddy/Caddyfile:
:9900 {
reverse_proxy 127.0.0.1:9876 {
transport http { read_timeout 0 write_timeout 0 response_header_timeout 0 }
flush_interval -1
header_up Connection {>Connection}
header_up Upgrade {>Upgrade}
}
}
sudo systemctl restart caddy
Then point your config at port 9900:
{
"mcpServers": {
"burp": {
"type": "sse",
"url": "http://127.0.0.1:9900/",
"headers": { "Authorization": "Bearer PASTE_TOKEN_FROM_SERVER_TAB" }
}
}
}
Pre-built Caddyfile: configs/Caddyfile
Claude Desktop only supports stdio transport. Bridge it with supergateway:
{
"mcpServers": {
"burp": {
"command": "npx",
"args": ["-y", "supergateway", "--sse", "http://127.0.0.1:9876/", "--header", "Authorization: Bearer PASTE_TOKEN_FROM_SERVER_TAB"]
}
}
}
chmod +x configs/setup.sh
./configs/setup.sh
Builds the JAR, optionally configures Caddy, and prints the MCP config to add.
+---------------------------------------------------+
| BURP SUITE PRO |
| +---------------------------------------------+ |
| | BurpMCP-Ultra Extension | |
| | | |
| | Montoya API --> Bridge Layer (32 bridges) | |
| | | | | |
| | Event Bus Tool Registry (150 tools) | |
| | | | | |
| | +------- MCP Server Core -------+ | |
| | (Kotlin SDK 0.8.3) | | |
| | | | | |
| | +----------+----------+ | | |
| | SSE :9876 SSE :9877 Dashboard | | |
| | :9878 | | |
| +---------------------------------------------+ |
+---------------------------------------------------+
To run (inside Burp):
To build from source:
gradle/gradle-daemon-jvm.properties), so ./gradlew auto-runs under JDK 17 as long as
one is installed and discoverable../gradlew / gradlew.bat).The Gradle wrapper is committed, so no separate Gradle install is needed.
Linux / macOS
git clone https://github.com/Cy-S3c/BurpMCP-Ultra.git
cd BurpMCP-Ultra
# Gradle auto-selects an installed JDK 17 for the build daemon, so this works even if your
# default `java` is Burp's Java 25. If no JDK 17 is discoverable, install one (or set JAVA_HOME).
./gradlew shadowJar
# Output: build/libs/burpmcp-ultra-2.3.1.jar
Windows (PowerShell / cmd)
git clone https://github.com/Cy-S3c/BurpMCP-Ultra.git
cd BurpMCP-Ultra
:: Gradle auto-selects an installed JDK 17 for the build daemon, so this works even if your
:: default java is Burp's Java 25. If no JDK 17 is discoverable, install one (or set JAVA_HOME).
gradlew.bat shadowJar
:: Output: build\libs\burpmcp-ultra-2.3.1.jar
If no JDK 17 is found, Gradle fails with a clear "no compatible daemon JVM" error instead of silently producing a broken JAR. Kotlin 2.1.20 cannot even compile the Gradle build scripts under Java 22+, which is why the daemon is pinned to JDK 17.
BurpMCP-Ultra/
├── build.gradle.kts # Build configuration
├── gradle/ # Wrapper + daemon-JVM pin (JDK 17)
├── configs/ # Ready-to-use config files (Caddyfile, MCP JSON, setup.sh)
├── src/main/kotlin/com/burpmcp/ultra/
│ ├── core/ # Extension entry point + helpers
│ ├── bridge/ # 32 Montoya API bridges
│ ├── tools/ # 37 tool category modules (150 tools)
│ ├── safety/ # Scope gate, action policy, ReDoS-safe regex
│ ├── transport/ # MCP server + dashboard + security
│ ├── events/ # Unified event bus
│ ├── state/ # State management
│ └── ui/ # Swing UI tab
├── src/test/ # 105 unit tests
└── docs/ # Tool catalog + capability review
AI-powered MCP server for Burp Suite Professional — 149 tools across proxy, scanner, inline fuzzer, race conditions, guided injection, JWT/IDOR attacks, recon & OOB, with a real-time dashboard and har
개요
AI-powered MCP server for Burp Suite Professional — 149 tools across proxy, scanner, inline fuzzer, race conditions, guided injection, JWT/IDOR attacks, recon & OOB, with a real-time dashboard and hardened localhost security. Drive Burp from Claude Code or any MCP client.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
BurpMCP Ultra은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-05. AI-powered MCP server for Burp Suite Professional — 149 tools across proxy, scanner, inline fuzzer, race conditions, guided injection, JWT/IDOR attacks, recon & OOB, with a real-time dashboard and hardened localhost security. Drive Burp from Claude Code or any MCP client.