octomind MCP Server

Use This MCP server To

Create new end-to-end tests programmatically Execute e2e tests within local development environments Manage and organize e2e test suites Automatically fix failing tests using Octomind's auto-fix Integrate Octomind testing tools into CI/CD pipelines Leverage Octomind resources for test optimization Monitor test execution results and logs Enable AI-driven test generation and maintenance

README

octomind mcp server: let agents create and manage e2e tests

Octomind Logo

Octomind provides a whole e2e platform for test creation, execution and management including auto-fix. With this MCP server you can use Octomind tools and resources in your local development environment and enable it to create new e2e tests, execute them and more. see https://octomind.dev/ and https://octomind.dev/docs/mcp/install-octomind-mcp for more details.

See it in action together with testrail mcp

config

The server uses 2 environment variables:

APIKEY the apikey for octomind api
OCTOMIND_API_URL base url for the api endpoint to use. defaults to https://app.octomind.dev/api
LOG_FILENAME the file to write logs to (only for debugging). If not set, logging is disabled
LOG_LEVEL the log level to use. defaults to info

Tools

The following tools are implemented in this MCP server:

search - Search the Octomind documentation for a given query
getTestCase - Retrieve a test case for a given test target and test case ID
executeTests - Trigger test execution for a given test target on a specified URL
getEnvironments - List environments for a test target
createEnvironment - Create a new environment for a test target
updateEnvironment - Update an existing environment
deleteEnvironment - Delete an environment
getTestReports - Retrieve test reports for a test target
getTestReport - Get a specific test report by ID
discovery - Create a test case with a description or prompt
getPrivateLocations - List all private locations configured for the organization
getVersion - Get the current version of the Octomind MCP server

Installation

You can get configuration snippets for different clients by running:

npx @octomind/octomind-mcp --clients

This will output configuration examples for Claude Desktop, Cursor, and Windsurf. Here are the configuration files for most clients:

Installing via Smithery

To install octomind-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @OctoMind-dev/octomind-mcp --client claude

Claude Desktop (.claude-config.json)

{
  "mcpServers": {
    "octomind-mcp": {
      "name": "Octomind MCP Server",
      "command": "npx",
      "args": [
        "-y",
        "@octomind/octomind-mcp@latest"
      ],
      "env": {
        "APIKEY": "your-api-key-here"
      }
    }
  }
}

Cursor (cursor.json)

{
  "mcpServers": {
    "octomind-mcp": {
      "name": "Octomind MCP Server",
      "command": "npx",
      "args": [
        "-y",
        "@octomind/octomind-mcp@latest"
      ],
      "env": {
        "APIKEY": "your-api-key-here"
      }
    }
  }
}

Windsurf (mcp_config.json)

{
  "mcpServers": {
    "octomind-mcp": {
      "name": "Octomind MCP Server",
      "command": "npx",
      "args": [
        "-y",
        "@octomind/octomind-mcp@latest"
      ],
      "environment": {
        "APIKEY": "your-api-key-here"
      }
    }
  }
}

Note: Replace your-api-key-here with your actual API key.

To get an APIKEY see here https://octomind.dev/docs/get-started/execution-without-ci#create-an-api-key

octomind-mcp FAQ

How do I install the octomind-mcp server?

Follow the installation guide at https://octomind.dev/docs/mcp/install-octomind-mcp to set up the server in your environment.

Can octomind-mcp automatically fix failing tests?

Yes, it includes auto-fix features to help maintain and repair tests automatically.

Does octomind-mcp support integration with CI/CD pipelines?

Yes, it can be integrated into CI/CD workflows to automate test execution and reporting.

What kind of tests can I create with octomind-mcp?

You can create comprehensive end-to-end (e2e) tests for web applications and services.

Is octomind-mcp compatible with multiple LLM providers?

Yes, it works with various LLMs including OpenAI, Anthropic Claude, and Google Gemini for enhanced AI capabilities.

How does octomind-mcp improve test management?

It centralizes test creation, execution, and auto-fix, simplifying test lifecycle management.

Where can I find more documentation about octomind-mcp?

Detailed docs are available at https://octomind.dev/docs/mcp/install-octomind-mcp.