Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.testsprite.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

​
VS Code

  1. Stop VS Code completely
pkill -f "Code"
  1. Remove existing TestSprite MCP installation
npm uninstall -g @testsprite/testsprite-mcp
npm cache clean --force
  1. Clear VS Code workspace cache (optional)
rm -rf .vscode/.mcp-cache 2>/dev/null || true
  1. Reinstall latest version
npm install -g @testsprite/testsprite-mcp@latest
  1. Verify installation
npx @testsprite/testsprite-mcp@latest --version
  1. Restart VS Code
code .
  1. Reload VS Code window
    1. Press
    2. Type the following command: 
      "Developer: Reload Window"
    3. Press ⇧ Enter

​
Verification Steps

After reinstalling, verify the MCP server is working:
  1. Test the server directly
npx @testsprite/testsprite-mcp@latest --version
  1. Check if the server responds
npx @testsprite/testsprite-mcp@latest --help

​
Advanced Troubleshooting

If reinstallation doesn’t resolve the issue:
  1. Verify Node.js version (requires 22+)
node --version
  1. Update if needed
nvm install 22
nvm use 22

​
Common Error Messages

  • Ensure Node.js 22+ is installed
  • Restart your terminal/IDE
  • Check PATH environment variable
  • Verify internet connection
  • Check firewall settings
  • Validate API key format
  • 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
  1. IDE and configuration details
    • IDE name and version
    • Operating system version
    • Screenshot of the MCP Server panel
    • Relevant configuration files (sanitized)