mcpField
T
threadmine

threadmine

Local
github.com/maschiojvDeveloper Tools0Updated 2d ago
Repository

About threadmine

threadmine is an MCP server for AI assistants that analyzes Java thread dumps, aimed at developers investigating JVM issues. It returns detected problems, a health score, and a link to an interactive report.

Key features

  1. 01Analyze JVM thread dumps
  2. 02Detect deadlocks and CPU spikes
  3. 03Find pool exhaustion and virtual thread pinning
  4. 04Return a health score and report link
  5. 05Fetch an earlier analysis by ID

Use cases

  1. 01Investigate deadlocks in a JVM application
  2. 02Look into CPU spikes or pool exhaustion
  3. 03Check for virtual thread pinning
  4. 04Review earlier analysis results in chat

MCP support

The MCP server provides tools to analyze thread dumps and retrieve an analysis by ID. Analysis uses the workspace's daily quota; retrieving an existing result is read-only.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dev-threadmine": {
      "command": "npx",
      "args": [
        "-y",
        "@threadmine/mcp"
      ],
      "env": {
        "THREADMINE_API_KEY": "<THREADMINE_API_KEY>",
        "THREADMINE_API_URL": "<THREADMINE_API_URL>"
      }
    }
  }
}
Run commandnpx -y @threadmine/mcp
Environment variables to set
THREADMINE_API_KEYSecretOptional. Without it, analyses run anonymously (5/hour per IP, report expires in 7 days)
THREADMINE_API_URLOverride the ThreadMine API endpoint (default: https://api.threadmine.dev)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@threadmine/mcp0.2.0

Tools

2

Saved tool list · updated 2d ago

ParameterTypeRequiredDescription
titlestringNoOptional title for the analysis
contentstringNoRaw thread dump text (jstack / jcmd Thread.print / kill -3 output)
file_pathstringNoAbsolute path to a thread dump file — preferred for large dumps

Details

From the project 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.

Tools

ToolWhat it doesQuota
analyze_thread_dumpUploads a thread dump (inline text or file path) and returns detected problems, health score (0-100) and the report linkConsumes 1 analysis from your daily quota
get_analysisFetches a previous analysis by idFree (read-only)

Setup

  1. Create a free account at threadmine.dev.
  2. Create an API key: Settings → API Keys in the web app.
  3. Add the server to your assistant:

Claude Code

claude mcp add threadmine -e THREADMINE_API_KEY=tf_live_xxx -- npx -y @threadmine/mcp

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

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

Usage

Ask your assistant things like:

  • "Analyze this thread dump: <paste>"
  • "Run the dump at /tmp/threaddump.txt through ThreadMine"
  • "What did analysis <id> find? Any deadlocks?"

Notes

  • Analyses run in the workspace the API key belongs to and count against that workspace's plan quota (the Free plan includes a daily quota — pricing).
  • THREADMINE_API_URL can override the API endpoint (self-hosted / staging).
  • Requires Node.js ≥ 20.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.