Installation

Get TestSprite MCP Server up and running in your IDE in under 2 minutes.

Prerequisites

Before installing TestSprite MCP Server, ensure you have:

Compatible IDE - Cursor or VSCode with MCP support
TestSprite Account - Sign up for free (opens in a new tab)
Node.js >= 22 - Download Node.js (opens in a new tab) (required for running MCP server)

Get Your API Key

First, you'll need a TestSprite API key for any installation method:

Sign in to your TestSprite Dashboard (opens in a new tab)
Navigate to API Keys under Settings
Click "New API Key"
Copy your API key (you'll need it for installation)

Check Your NodeJS Installation

Before proceeding with installation, verify you have Node.js version 22 or higher:

Open your terminal (PowerShell or Command Prompt on Windows, Terminal on Mac/Linux)
Check your Node.js and npm versions:

node --version
npx --version

Verify Node.js is >= 22 (e.g., v22.1.0) and npx is >= 10 (e.g., 10.2.4)

If you don't have Node.js 22+ and npx 10+ installed:

Download the latest version from nodejs.org (opens in a new tab)
Install following the installer instructions
Restart your terminal and verify again with node --version and npx --version

Note: TestSprite MCP Server requires Node.js 22 or higher to function properly.

One-Click Installation (Cursor)

The easiest way to install TestSprite MCP Server in Cursor:

Get your API key (see above)
Click the one-click install link - Install TestSprite MCP Server
Enter your API key in Cursor
Start testing!

Manual Installation

Configure Your IDE

For Cursor

Open Cursor Settings (cmd/ctrl + shift + j)
Navigate to Tools & Integration
Click Add custom MCP
Add the following configuration:

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

For Claude Code

Navigate to your project directory in terminal:
```
cd /path/to/your/project
```

Paste the installation command into your terminal:

claude mcp add TestSprite --env API_KEY=your_api_key -- npx @testsprite/testsprite-mcp@latest

Replace your_api_key with your actual TestSprite API key
Run the installation command
Verify the installation by running this command in your project directory:
```
claude mcp list
```
You should see:
```
TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Connected
```
Note: Installing the MCP server this way adds TestSprite only to Claude Code under the current project directory. If you're using Claude Code in another project directory, you'll need to add the MCP server again. For installing the MCP server under different scopes (e.g. global), refer to the Claude Code MCP documentation (opens in a new tab).

For VSCode

Open the Command Palette (cmd/ctrl + shift + p)
Run the MCP: Add Server command
Choose Command (stdio) installation type
Type npx @testsprite/testsprite-mcp@latest for Command to run
Type TestSprite for the MCP server identifier/name
Choose the scope where you want the MCP server to be configured
Add the env configuration:

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

For Other MCP-Compatible IDEs

Add this configuration to your MCP settings:

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Installation Verification

For Cursor

Check if the green dot shows up on the TestSprite MCP server icon, and the tools have been loaded successfully.

For VSCode

After installation, click the start button above the TestSprite MCP entry in the mcp.json file you have jsut confifured. If the server started with no errors and all the tools have been loaded, you have installed the MCP server successfully.

Success Indicators

check_circle Your AI assistant can see TestSprite MCP tools
check_circle No "command not found" errors
check_circle Ready to start testing your projects

Quick Test

Try prompting: "Help me test this project with TestSprite" - your assistant should offer to use TestSprite MCP tools.

Uninstallation

To remove TestSprite MCP Server:

Remove the configuration from your IDE's MCP settings
Restart your IDE

Next Steps

check_circle Installation Complete!

Now you're ready to run your first test. Continue to Your First Test to see TestSprite MCP Server in action.

Overview Your First Test