ThreadMine MCP server — thread dumps in Claude Code

Quick answer

ThreadMine is a Java thread dump analyzer with AI — detects deadlocks, CPU spikes, pool exhaustion and virtual thread pinning. Free online, no signup. The official MCP server (@threadmine/mcp) puts that analysis inside your assistant: paste the dump in the chat and get the diagnosis without switching windows.

What is the ThreadMine MCP server

MCP (Model Context Protocol) is the open standard that connects AI assistants to external tools. With ThreadMine’s official MCP server installed, Claude Code, Claude Desktop and Cursor use ThreadMine: during an incident you paste the thread dump into the conversation (or point at the file path) and the assistant returns the detected problems, the health score and the link to the full interactive report.

The package is published on npm as @threadmine/mcp and listed in the official MCP registry as dev.threadmine/mcp. There are two tools: one that analyzes a new dump and a read-only one to revisit analyses.

Install

Before you installCreate a free API key: go to threadmine.dev → Settings → API Keys. The key (format tf_live_…) replaces the placeholder below.

Claude Code

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

Claude Desktop · Cursor

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

How it works

01
Create your free API key
Once, in the ThreadMine app. The key identifies your account and workspace.
02
Paste the dump in the chat (or point at the file)
Ask the assistant to analyze it: the dump goes through the analyze_thread_dump tool — large dumps go by file path, without blowing up the context.
03
Get the diagnosis in the chat
Detected problems with severity and recommendation, a 0–100 health score, and the link to the full interactive report on ThreadMine.

The tools

Tool	What it does	Quota
analyze_thread_dump	Uploads a thread dump (text or file path) and returns detected problems, health score and the report link.	Consumes 1 analysis/day
get_analysis	Fetches an existing analysis by id — follow-ups without re-uploading the dump.	Free (read-only)

Package & source

The server is open source (MIT) and published in the official MCP registry as dev.threadmine/mcp. Security questions? See the security page.

GitHub npm — @threadmine/mcp Glama — MCP directory

Frequently asked questions

Does the MCP server work on the Free plan?

Yes. Any ThreadMine account can create an API key and use the MCP server. Each analysis consumes one unit of your plan’s daily quota — on Free, within the free daily limit.

Does analyzing via MCP consume my quota?

The analyze_thread_dump tool consumes 1 analysis from the daily quota — the same cost as uploading through the UI. get_analysis is read-only and consumes nothing, so follow-ups on an existing analysis are free.

Does it work in Cursor and Claude Desktop?

Yes — the same npm package (@threadmine/mcp) works in Claude Code, Claude Desktop and Cursor. Only the config location changes; both formats are in the install section.

Where do my thread dumps go?

The dump is sent over HTTPS to the ThreadMine API and analyzed in your API key’s workspace, exactly like a UI upload. Retention and security details are on the security page.

Analyze your next incident without leaving the editor

Create your free account, generate an API key and install the MCP server with one command.

Create free account

Analyze JVM thread dumps without leaving Claude Code