Thunder Client MCP Server

What it does

The official MCP server for Thunder Client, the API client for VS Code and JetBrains. It lets an AI assistant build Thunder Client collections from your source code or an API spec, create and edit requests (including from a curl command), add tests and scripts, run requests and whole collections, and generate reports. Version 2 was announced on 1 November 2026. The assistant sees environment variable names but not their values, saved auth values are masked, and it does see the response bodies of requests it runs. MIT licensed.

Who it's for

Developers who test APIs with Thunder Client and want Claude Code, Codex, Copilot, Cursor or another agent to write and run those requests and tests for them.

How to set it up

1. You need Node.js 22 or later, the Thunder Client extension (installed and up to date) and the Thunder Client CLI 2.1.0 or later. Install the CLI and check it:

   bashCopy

   npm i -g @thunderclient/cli@latest
   tc --version

2. Claude Code or Codex: add the server from your terminal, then restart the tool (run /mcp in Claude Code, or codex mcp list, to check it's connected):

   bashCopy

   claude mcp add thunderclient -- npx -y thunderclient-mcp
   codex mcp add thunderclient -- npx -y thunderclient-mcp

3. Cursor: add this to .cursor/mcp.json in your project or ~/.cursor/mcp.json for all projects, then restart Cursor. Copilot Chat uses the same block in ~/.copilot/mcp-config.json:

   jsonCopy

   {
     "mcpServers": {
       "thunderclient": {
         "command": "npx",
         "args": ["-y", "thunderclient-mcp"]
       }
     }
   }

4. Test it by asking: "Check that Thunder Client is set up for my project." The assistant should report the CLI version, the data path, and your collections and environments. Some things still need the Thunder Client UI: creating and editing environments, AWS and NTLM auth, deleting collections or folders, and SSE, WebSocket and gRPC requests. As of 4 November 2026, the pricing page (thunderclient.com/pricing) lists the MCP server on the Free plan, which allows 10 collections and 50 requests per collection.

Check the official Thunder Client MCP Server docs for the latest steps.

Install Thunder Client MCP Server in your client

Runs on your computer. Needs: Node.js 22 or later, plus the Thunder Client extension and CLI (2.1.0 or later). Sign-in or keys: None.

claude mcp add --transport stdio thunderclient -- npx -y thunderclient-mcp

{
  "mcpServers": {
    "thunderclient": {
      "command": "npx",
      "args": [
        "-y",
        "thunderclient-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "thunderclient": {
      "command": "npx",
      "args": [
        "-y",
        "thunderclient-mcp"
      ]
    }
  }
}

{
  "servers": {
    "thunderclient": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "thunderclient-mcp"
      ]
    }
  }
}

codex mcp add thunderclient -- npx -y thunderclient-mcp

[mcp_servers.thunderclient]
command = "npx"
args = ["-y", "thunderclient-mcp"]

• Install the CLI first with npm i -g @thunderclient/cli@latest, and keep the Thunder Client extension up to date.
• On Windows, if you see spawn npx ENOENT, see the Windows npx fix.
• If the server shows as failed or disconnected, see fixing MCP error -32000.
• Compare every server's runtime and sign-in needs in the MCP server requirements table.

Checked Nov 4, 2026 against the official docs. Snippets use placeholders; keep real keys out of files you commit. Windsurf is not listed because we have not verified its format.

Set it up / Fixes

Step-by-step guides for getting Thunder Client MCP Server running and fixing common errors.

• Setup:How to add an MCP server to Cursor
• Setup:The best MCP servers for Claude Code
• Fix:Fix "spawn npx ENOENT" for MCP servers on Windows

Example prompts

Create a collection called Orders API from the Express routes in src/routes, with one folder per resource.

Add tests to every request in the Orders folder: check the status code, a response time under 500 ms, and one key field in the body.

Run the Orders API collection and give me a report of anything that failed.

Made Thunder Client MCP Server? Add the badge

If you like, show that Thunder Client MCP Server is listed and hand-checked here. It's optional: listings are free and we never ask for a link back.

[![Hand-checked on PluginStack](https://www.pluginstackai.com/badge/hand-checked.svg)](https://www.pluginstackai.com/plugins/thunder-client-mcp/)

<a href="https://www.pluginstackai.com/plugins/thunder-client-mcp/"><img src="https://www.pluginstackai.com/badge/hand-checked.svg" alt="Hand-checked on PluginStack" width="226" height="28"></a>

About the badge

Free: MCP Starter Checklist

After you set this tool up, use the one-page checklist so your next MCP server doesn't fail on first connect.