Installation

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

Prerequisites

Before installing TestSprite MCP Server, ensure you have:

1. Compatible IDEs
2. TestSprite Account - Sign up for free
3. Node.js >= 22 - Download Node.js (required for running MCP server)

Which IDEs and editors does TestSprite support?

TestSprite supports Trae, Cursor, Claude Code, Windsurf, VS Code, and GitHub Copilot. Simply install our MCP Server get started.

How do I check my Node.js version?

Run node --version to check your version. For detailed setup instructions, see Node.js Configuration.

Get Your API Key

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

1. Sign in to your TestSprite Dashboard
2. Switch to the workspace the MCP Server should work in, then open Workspace Settings → Connections → API Keys
3. Click “New API Key”
4. Copy your API key (you’ll need it for installation)

The key acts in the workspace you minted it in: projects the MCP Server creates belong to that workspace and draw on its balance. Keys starting with sk-user- predate workspace keys; they keep working and act in your default workspace. See API Keys for expiry and revocation.

Installation

Follow the instructions for your specific client to add the TestSprite MCP server.

Trae

1. Get your API key.
2. In Trae, navigate to AI Sidebar > AI Management.
3. Select MCP > Add > Add from Marketplace.
4. Search for TestSprite and add to your MCP list.

5. Enter your API key in Trae and hit Confirm
6. Select Builder with MCP and start testing.

Cursor

Important: Cursor’s default “Run in Sandbox” mode limits TestSprite’s functionality. See Cursor Sandbox Mode Configuration below for setup instructions.

You can install TestSprite MCP Server in Cursor using either one-click installation for quick setup or manual installation for full control.

One-click Installation

The easiest way to install TestSprite MCP Server in Cursor:

1. Get your API key.
2. Click this one-click install link .
3. Enter your API key in Cursor.
4. Start testing.

Manual Installation

1. Open Cursor Settings ( ⌘⇧J )
2. Navigate to Tools & Integration
3. Click Add custom MCP
4. Add the following configuration:

Cursor Configuration

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

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

Cursor Sandbox Mode Configuration

Cursor Sandbox Mode Configuration Cursor has recently updated and by default will run MCP tools in the allowlist in “Run in Sandbox” mode. This mode limits the MCP tools’ functionalities and will prevent successful invocations of TestSprite’s testing procedures.

To ensure full functionality of TestSprite MCP Server in Cursor:

1. Go to Cursor → Settings → Cursor Settings

2. Go to Chat → Auto-Run → Auto-Run Mode and change the setting to “Ask Everytime” or “Run Everything”

Claude Code

1. Navigate to your project directory in terminal:

   cd /path/to/your/project
   

2. Paste the installation command into your terminal:

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

3. Replace your_api_key with your actual TestSprite API key

4. Run the installation command

5. Verify the installation by running this command in your project directory:

   claude mcp list
   

   You should see:

   Example Terminal Output

   TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Connected
   
   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

Antigravity

1. Open the MCP store via the ... dropdown at the top of the editor’s agent panel.

2. Click on “Manage MCP Servers”.

3. Click on “View raw config”.

4. Add the following configuration to mcp_config.json:

   Antigravity Configuration

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

VSCode

1. Open the Command Palette ( ⌘⇧P )
2. Run the MCP: Add Server command
3. Choose Command (stdio) installation type
4. Type npx @testsprite/testsprite-mcp@latest for Command to run
5. Type TestSprite for the MCP server identifier/name
6. Choose the scope where you want the MCP server to be configured
7. Add the env configuration:

VS Code Configuration

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

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

Other IDEs

Add this configuration to your MCP settings:

Other IDE Configuration

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

Installation Verification

Success Indicators

• Your AI assistant can see TestSprite MCP tools
• No “command not found” errors
• 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:

1. Remove the configuration from your IDE’s MCP settings
2. Restart your IDE