Threadmine

dev.threadminePublished by threadmine.devv0.2.0Updated Oct 30, 2026

Analyze JVM thread dumps with ThreadMine: deadlocks, CPU spikes, pool exhaustion, health score.

VerifiedSTDIODesktop onlyDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

ThreadMine analyzes JVM thread dumps pasted into an AI assistant, returning detected problems, a 0-100 health score and a report link.

What you can do
  • Upload a thread dump, inline text or a file path, and get detected problems, a health score and a report link
  • Fetch a previous analysis by its id, read-only and without consuming quota
  • Diagnose deadlocks, CPU spikes, pool exhaustion and virtual thread pinning from jstack or similar output
When to use it
Useful when a Java or Spring Boot service hangs or spikes and you have a thread dump to interpret, or when you want a quick diagnosis of a stuck JVM without leaving the chat.
Requirements
Runs locally over stdio via npx, so Node.js 20 or newer is needed. Network access to the ThreadMine API over TLS. An optional THREADMINE_API_KEY enables workspace storage and higher quotas; THREADMINE_API_URL can point at another endpoint.
Before you install
The dump is sent to a third-party API; dumps can contain hostnames, class and package names and SQL fragments, so anonymize production dumps first if policy requires it. Without a key, reports are public links that anyone holding the URL can open and expire after 7 days. Anonymous use is limited to 5 analyses per hour and 20 per day per IP.

Installation

In SourceWeft

  1. Open Threadmine in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolWhat it does
analyze_thread_dumpUploads a thread dump (inline text or file path) and returns detected problems, health score (0-100) and the report link
get_analysisFetches a previous analysis by the id analyze_thread_dump returned. Read-only, consumes nothing

Setup

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

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

Claude Code, server only

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

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

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

With or without an account

Without an API keyWith THREADMINE_API_KEY
Limit5 analyses per hour, 20 per day, per IPYour plan's quota (pricing)
ReportPublic link (threadmine.dev/resultado/...), anyone with it can open it, expires after 7 daysPrivate, 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_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

Source: README.md at commit 317781c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.0LatestOct 29, 2026
  2. v0.1.0Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts