English Français العربية

dev.threadmine/mcp

Official registry Health

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @threadmine/mcp
Claude Code 
claude mcp add dev-threadmine-mcp -e 'THREADMINE_API_KEY=<your threadmine_api_key>' -e 'THREADMINE_API_URL=<THREADMINE_API_URL>' -- npx -y @threadmine/mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dev-threadmine-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@threadmine/mcp@0.1.0"
            ],
            "env": {
                "THREADMINE_API_KEY": "<your threadmine_api_key>",
                "THREADMINE_API_URL": "<THREADMINE_API_URL>"
            }
        }
    }
}

Environment variables

  • THREADMINE_API_KEY required secret ThreadMine API key (create at app.threadmine.dev, Settings > API Keys)
  • THREADMINE_API_URL Override the ThreadMine API endpoint (default: https://api.threadmine.dev)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ThreadMine MCP Server
  2. Tools
  3. Setup
  4. Usage
  5. Notes
  6. License

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

Frequently asked questions

What is dev.threadmine/mcp?

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

How do I install dev.threadmine/mcp?

It runs on your machine. In Claude Code: claude mcp add dev-threadmine-mcp -e 'THREADMINE_API_KEY=<your threadmine_api_key>' -e 'THREADMINE_API_URL=<THREADMINE_API_URL>' -- npx -y @threadmine/mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does dev.threadmine/mcp need an API key?

Yes. It expects THREADMINE_API_KEY, which you set in its configuration.

Is dev.threadmine/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains dev.threadmine/mcp?

It is published by maschiojv. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.