Threadmine

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

Setup

Claude Code plugin (MCP server plus a skill that tells Claude when to use it)

claude plugin marketplace add maschiojv/threadmine-mcpclaude plugin install threadmine@threadmine-plugins

Claude Code, server only

claude mcp add threadmine -- npx -y @threadmine/mcp

Claude Desktop / Cursor (claude_desktop_config.json / .cursor/mcp.json)

{  "mcpServers": {    "threadmine": {      "command": "npx",      "args": ["-y", "@threadmine/mcp"]    }  }}

With or without an account

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_URL overrides the API endpoint (self-hosted / staging). THREADMINE_SITE_URL overrides the site used in anonymous report links.
• Requires Node.js ≥ 20.

License

MIT