Skip to main content

​
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)
TestSprite supports Trae, Cursor, Claude Code, Windsurf, VS Code, and GitHub Copilot. Simply install our MCP Server get started.
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:
API Key
  1. Sign in to your TestSprite Dashboard
  2. Navigate to API Keys under Settings
  3. Click “New API Key”
  4. Copy your API key (you’ll need it for installation)

​
One-Click installation

  • Trae
  • Cursor
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.
trae
  1. Enter your API key in Trae and hit Confirm
  2. Select Builder with MCP and start testing.

​
Manual Installation

Follow the instructions for your specific client to add the TestSprite MCP server.
  • Cursor
  • Claude Code
  • VSCode
  • Other IDEs
  1. Open Cursor Settings ( )
  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"
      }
    }
  }
}
  1. Check if the green dot shows up on the TestSprite MCP server icon, and the tools have been loaded successfully.
Cursor Success

​
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
⌘I