Test Execution Issues

Solutions to test execution problems with TestSprite MCP Server.

General Test Execution Problems

If you experience issues where tests fail to run, generate, or execute properly, please follow the solution below:

Most test execution issues can be resolved by completely deleting the generated /testsprite_tests directory and re-running the workflow from the beginning. If the problem persists, try reinstalling the TestSprite MCP Server.

Cursor IDE

Quick Reset (Recommended)

1. Open Cursor IDE
2. Go to the MCP Server panel/sidebar
3. Find “TestSprite” in the server list
4. Toggle the TestSprite MCP server OFF
5. Wait 5-10 seconds
6. Toggle the TestSprite MCP server ON
7. Wait for the server to reconnect (green status indicator)

Reload Cursor Entirely

1. Press ⌘⇧P
2. Type the following command:

"Developer: Reload Window" 

3. Press ⇧ Enter

VS Code

macOS/Linux

1. Stop VS Code completely

pkill -f "Code"

2. Remove existing TestSprite MCP installation

npm uninstall -g @testsprite/testsprite-mcp
npm cache clean --force

3. Clear VS Code workspace cache (optional)

rm -rf .vscode/.mcp-cache 2>/dev/null || true

4. Reinstall latest version

npm install -g @testsprite/testsprite-mcp@latest

5. Verify installation

npx @testsprite/testsprite-mcp@latest --version

6. Restart VS Code

code .

7. Reload VS Code window
   1. Press ⌘⇧P
   2. Type the following command:
      "Developer: Reload Window" 
      
   3. Press ⇧ Enter

Windows

1. Stop VS Code completely

taskkill /F /IM Code.exe

2. Remove existing TestSprite MCP installation

npm uninstall -g @testsprite/testsprite-mcp
npm cache clean --force

3. Clear VS Code workspace cache (optional)

Remove-Item -Path .vscode\.mcp-cache -Recurse -Force -ErrorAction SilentlyContinue

4. Reinstall latest version

npm install -g @testsprite/testsprite-mcp@latest

5. Verify installation

npx @testsprite/testsprite-mcp@latest --version

6. Restart VS Code

code .

7. Reload VS Code window
   1. Press Ctrl⇧P
   2. Type the following command:
      "Developer: Reload Window" 
      
   3. Press ⇧ Enter

Using npx - No Global Installation

Update your VS Code settings to use npx instead:

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

Then reload VS Code:

1. Press ⌘⇧P
2. Type the following command:
   "Developer: Reload Window" 
   
3. Press ⇧ Enter

Verification Steps

After reinstalling, verify the MCP server is working:

In Terminal

1. Test the server directly

npx @testsprite/testsprite-mcp@latest --version

2. Check if the server responds

npx @testsprite/testsprite-mcp@latest --help

In your IDE

1. Look for TestSprite in the MCP server list
2. Check for green/connected status indicator
3. Try running a simple test command
4. Verify API key is properly configured

Advanced Troubleshooting

If reinstallation doesn’t resolve the issue:

System Requirements

1. Verify Node.js version (requires 22+)

node --version

2. Update if needed

nvm install 22
nvm use 22

Clear All Caches

For macOS/Linus

npm cache clean --force
rm -rf ~/.npm
rm -rf node_modules package-lock.json
npm install

For Windows (PowerShell)

npm cache clean --force
Remove-Item -Path "$env:USERPROFILE\.npm" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path node_modules -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -Path package-lock.json -Force -ErrorAction SilentlyContinue
npm install

Check API Connectivity

Using curl For macOS/Linux

curl -H "Authorization: Bearer your-api-key" https://api.testsprite.com/health

Using PowerShell (Windows)

Invoke-RestMethod -Uri "https://api.testsprite.com/health" -Headers @{"Authorization"="Bearer your-api-key"}

Common Error Messages

'Command not found' after reinstallation

• Ensure Node.js 22+ is installed
• Restart your terminal/IDE
• Check PATH environment variable

Server connection failed

• Verify internet connection
• Check firewall settings
• Validate API key format

Permission denied

• Use npx instead of global installation
• Fix npm permissions (see Installation Issues section)

When to Contact Support

If reinstallation doesn’t resolve your issue, please contact support with:

1. System information

node --version
npm --version
npx @testsprite/mcp-server --version

2. IDE and configuration details
   • IDE name and version
   • Operating system version
   • Screenshot of the MCP Server panel
   • Relevant configuration files (sanitized)