Skip to main content
Glama
ThreadMine MCP Server

ThreadMine MCP Server

by maschiojv

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

analyze_thread_dump

Uploads a thread dump (inline text or file path) and returns detected problems, health score (0-100) and the report link

get_analysis

Fetches a previous analysis by the id analyze_thread_dump returned. Read-only, consumes nothing

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-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

Without an API key

With THREADMINE_API_KEY

Limit

5 analyses per hour, 20 per day, per IP

Your plan's quota (pricing)

Report

Public link (threadmine.dev/resultado/...), anyone with it can open it, expires after 7 days

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_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

Available Tools

2 tools
analyze_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

    A4.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools are clearly distinct: one submits a new thread dump for analysis, the other retrieves results by ID. No overlap or ambiguity.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern ('analyze_thread_dump', 'get_analysis'), making them predictable and easy to distinguish.

    Tool Count4/5

    Two tools is reasonable for a specialized analysis server. It covers the essential create and retrieve operations without unnecessary bloat.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides tools to analyze and compare JVM thread dumps, summarizing thread states and detecting deadlocks.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      4
      25 npm
      MIT