Yes, Threadmine is free to use.

How do I install Threadmine?

Threadmine is a local plugin. Install it using npm package: @threadmine/mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Threadmine safe to use?

Threadmine scored 5.6/10 (moderate risk) in MCP Marketplace's automated security scan. It has 6 high or critical findings to review. It's listed, but review the security report on this page before installing.

What credentials does Threadmine need?

Threadmine requires the following credentials or environment variables: THREADMINE_API_KEY, THREADMINE_API_URL. You can find setup instructions on the server detail page.

What AI apps work with Threadmine?

Threadmine uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Threadmine MCP Server

by Maschiojv

Developer ToolsModerate5.6MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.6

Moderate5.6Moderate Risk

ThreadMine MCP server is a thin, well-structured client that uploads user-supplied JVM thread dumps to the ThreadMine API over TLS and polls for results, which matches its stated developer-tool purpose. Auth is optional by design: an API key is read from THREADMINE_API_KEY and sent as a bearer token, with placeholder handling and no hardcoded secrets. The main caveats are that dumps (which may contain hostnames and SQL fragments) leave the machine by design, and that file_path reads arbitrary absolute paths the assistant supplies, which is expected for this tool but worth noting. Supply chain analysis found 9 known vulnerabilities in dependencies (2 critical, 4 high severity). Package verification found 1 issue.

12 files analyzed · 14 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

env_vars

Check that this permission is expected for this type of plugin.

system_info

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Optional. Without it, analyses run anonymously (5/hour per IP, report expires in 7 days)Required

Environment variable: THREADMINE_API_KEY

Override the ThreadMine API endpoint (default: https://api.threadmine.dev)Optional

Environment variable: THREADMINE_API_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "dev-threadmine-mcp": {
      "env": {
        "THREADMINE_API_KEY": "your-threadmine-api-key-here",
        "THREADMINE_API_URL": "your-threadmine-api-url-here"
      },
      "args": [
        "-y",
        "@threadmine/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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

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

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

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.