Skip to main content

Testiny MCP Server

The Testiny MCP (Model Context Protocol) Server enables AI tools like Claude Desktop, VS Code with Copilot, and other MCP-compatible applications to interact directly with your Testiny project data. This allows AI assistants to read test cases, create test runs, update test results, and manage your testing workflow seamlessly.

Setup​

To use the Testiny MCP server, you'll need to configure it with your Testiny credentials and add it to your AI tool's MCP configuration.

Prerequisites​

  • A Testiny account with API access
  • A Testiny paid or trial plan
  • An optional API key from your Testiny API Keys settings
  • If no API key is used, the Authorization header is not needed and OAuth will be used instead

Configuration Examples​

Here are examples of how to configure the MCP server with specific clients. You can use the MCP server with any MCP compatible client (protocol '2025-06-18')

Add the following to your Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "testiny": {
      "url": "https://app.testiny.io/api/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}
Security Notice

Treat your API key like a password and keep it secure. The API key inherits the same permissions as the user who created it. Consider creating dedicated API keys with limited project access for MCP server usage.

Available Tools​

The Testiny MCP server provides the following tools for AI assistants to interact with your Testiny data:

Project Management​

  • listProjects - Retrieve all accessible Testiny projects
  • listTestCaseFolders - Browse test case folder structure within projects
  • listTestCases - Get test cases with optional keyword filtering
  • listTestRuns - Get test runs with optional keyword filtering

Test Execution​

  • createTestRun - Create new test runs for organizing test execution
  • setTestResult - Update test case results (passed, failed, blocked, skipped)
  • getTestStatus - Check current test case status for one or all test cases within a test run
  • addTestResultComment - Add detailed comments to test results

Usage Examples​

Assisted Test Automation Integration​

You can ask your AI assistant to help automate test result reporting:

"Create a new test run called 'Sprint 24 Regression Tests' in the Mobile App project and execute the test case TC-123"

The AI assistant will:

  1. Find the Mobile App project using listProjects
  2. Create the test run using createTestRun
  3. Try to execute the steps in the specified test case
  4. Update the test result using setTestResult
  5. Add comments using addTestResultComment
Prompt Hint

Always include enough context information for the assistant to be able to use e.g. a browser MCP server with URLs and test logins

Code Generation Example​

Generate test automation code based on your Testiny test cases:

"Generate Selenium WebDriver test code for test case TC-456 in Java."

The AI assistant will:

  1. Retrieve the test case details using listTestCases
  2. Analyze the test steps and expected results
  3. Generate appropriate automation code
  4. Suggest how to integrate with your test reporting using setTestResult
Prompt Hint

Include information about specific libraries, code style and existing test structure like page objects in your prompt.

Troubleshooting​

If you encounter issues with the MCP server:

  1. Verify API Key: When using an API key, ensure your API key is valid and has appropriate permissions
  2. Ensure OAuth enabled: Ensure that OAuth is enabled in your Testiny organization settings
  3. MCP feature available: Make sure you have a paid Testiny plan or are in the trial phase
  4. Check Base URL: Confirm the base URL matches your Testiny instance (Cloud vs Server)
  5. Project Access: Verify the API key's user has access to the projects you're trying to access

For additional support or feature requests, please contact our support team as explained here.