ThreadMine MCP Server
You can analyze JVM thread dumps and retrieve previous ThreadMine analyses directly from an AI assistant.
Upload a thread dump as inline text or via an absolute file path.
Get detected problems, a 0–100 health score, and a link to the full interactive report.
Detect deadlocks, CPU spikes, thread pool exhaustion, thread leaks, and virtual thread pinning.
Fetch an existing analysis by its UUID without consuming quota.
Use anonymously with rate limits/public reports, or with an API key for workspace/private reports.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ThreadMine MCP Server Check my threaddump at /tmp/dump.txt"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ThreadMine MCP Server
ThreadMine is a Java thread dump analyzer with AI — detects deadlocks, CPU spikes, pool exhaustion and virtual thread pinning. Free online, no signup.
Official MCP server for ThreadMine. Paste a JVM thread dump into your AI assistant — Claude Code, Claude Desktop or Cursor — and get back the detected problems, a health score and a link to the full interactive report, without leaving the chat.
No account needed. Without an API key the server uses the same public endpoint as the threadmine.dev analyzer. With a key, analyses land in your ThreadMine workspace.
Tools
Tool | What it does |
| Uploads a thread dump (inline text or file path) and returns detected problems, health score (0-100) and the report link |
| Fetches a previous analysis by the id |
Related MCP server: mcp-jvm-diagnostics
Setup
Claude Code plugin (MCP server plus a skill that tells Claude when to use it)
claude plugin marketplace add maschiojv/threadmine-mcp
claude plugin install threadmine@threadmine-pluginsClaude Code, server only
claude mcp add threadmine -- npx -y @threadmine/mcpClaude Desktop / Cursor (claude_desktop_config.json / .cursor/mcp.json)
{
"mcpServers": {
"threadmine": {
"command": "npx",
"args": ["-y", "@threadmine/mcp"]
}
}
}With or without an account
Without an API key | With | |
Limit | 5 analyses per hour, 20 per day, per IP | Your plan's quota (pricing) |
Report | Public link ( | Private, in your workspace |
To use your account, create an API key in the web app (Settings → API Keys) and set THREADMINE_API_KEY in the server's environment. For the plugin, export it in the shell that starts Claude Code; for the other setups, add it to the env block ("env": { "THREADMINE_API_KEY": "tf_live_xxx" }) or pass -e THREADMINE_API_KEY=tf_live_xxx to claude mcp add.
Usage
Ask your assistant things like:
"Analyze this thread dump:
<paste>""Run the dump at /tmp/threaddump.txt through ThreadMine"
"My Spring Boot app stopped answering, here's the jstack output"
"What did analysis
<id>find? Any deadlocks?"
Privacy
The dump is sent to the ThreadMine API over TLS. Thread dumps can carry hostnames, class and package names and SQL fragments. If your policy forbids sending production dumps to a third party, run them through tm-anon first: it anonymizes the dump locally, keeps the mapping on your machine, and ThreadMine still analyzes the result.
Hung tests in CI
When a JVM test hangs in GitHub Actions and the job hits timeout-minutes, threadmine-action dumps the stuck test JVM and writes the same diagnosis to the job summary and the pull request. It's one line in the workflow (uses: maschiojv/threadmine-action@v1) and needs no account.
Notes
THREADMINE_API_URLoverrides the API endpoint (self-hosted / staging).THREADMINE_SITE_URLoverrides the site used in anonymous report links.Requires Node.js ≥ 20.
License
MIT
Available Tools
2 toolsanalyze_thread_dumpA
Analyze a JVM thread dump with ThreadMine. Detects deadlocks, CPU spikes, thread pool exhaustion, thread leaks and virtual thread pinning. Returns detected problems, a health score (0-100) and a link to the full interactive report. Pass the dump text in "content", or "file_path" for large dumps. Consumes one analysis from the ThreadMine account's daily quota.
Inputs: title, content, file_path.
get_analysisA
Fetch an existing ThreadMine analysis by id (returned by analyze_thread_dump). Read-only: does NOT consume the daily analysis quota.
Inputs: analysis_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are clearly distinct: one submits a new thread dump for analysis, the other retrieves results by ID. No overlap or ambiguity.
Both tools follow a consistent verb_noun pattern ('analyze_thread_dump', 'get_analysis'), making them predictable and easy to distinguish.
Two tools is reasonable for a specialized analysis server. It covers the essential create and retrieve operations without unnecessary bloat.
The server covers the core workflow (analyze and retrieve results). Missing list or delete functionality are minor gaps but do not break the usage flow.
Maintenance
Related MCP Connectors
Scores how well AI agents will use your API, 0-100, from its OpenAPI spec. Free and read-only.
Investigate errors, track deployments, analyze performance, and manage application monitoring
Security + bug + perf + refactor audit for Python. Returns 0-10 score + MD report.
Scores your code across 12 areas, with findings, fix prompts, and re-assessment in your AI agent
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables scanning projects for dependency vulnerabilities, secrets, license conflicts, code quality, and git health, returning a 0-100 health score with actionable suggestions.5 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to analyze JVM thread dumps and GC logs, detecting deadlocks, lock contention, and GC pressure, without requiring a JVM runtime.740 npm2MIT
- FlicenseNot gradedqualityDmaintenanceProvides tools to analyze and compare JVM thread dumps, summarizing thread states and detecting deadlocks.-
- AlicenseAqualityCmaintenanceEnables AI agents to obtain deterministic, structured JVM production diagnostics—including deadlocks, hot locks, bottleneck frames, and planned GC/heap analysis—from thread dumps, GC logs, and heap histograms without hallucinating from raw logs.425 npmMIT