Octomind MCP Server

Octomind MCP Server

Let agents create and manage automated end-to-end tests with Octomind.

21
Stars
9
Forks
21
Watchers
5
Issues
Octomind MCP Server enables agents to interact with Octomind's end-to-end testing platform, allowing the creation, execution, and management of automated tests. It provides a server that integrates with various clients and allows for configuration, session management, and access to multiple testing tools and resources. The server supports extensible session storage options and integrates with external platforms like TestRail and Redis for advanced scenarios. It is designed to facilitate local development and enhance test management workflows.

Key Features

Automated test creation and execution
Integration with Octomind e2e platform
Session storage with in-memory and Redis support
Flexible client configuration examples
Environment management tools
Test report retrieval
Discovery and generation of test cases from prompts
Command line and environment variable configuration
Configurable logging and debugging options
Horizontal scaling with Redis backend

Use Cases

Automating creation of end-to-end tests for web applications
Executing and managing tests across multiple environments
Generating tests from descriptive prompts or existing documentation
Integrating with CI/CD pipelines for automated quality assurance
Managing test sessions with persistent storage solutions
Retrieving and analyzing test results and reports
Scaling test execution across multiple server instances
Facilitating local development of E2E test suites
Providing tools integration with clients like Claude Desktop and Cursor
Administering test environments and locations for teams and organizations

README

octomind mcp server: let agents create and manage e2e tests

smithery badge

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

Video Title

Configuration

Environment Variables

The server uses the following environment variables:

  • APIKEY - The API key for Octomind API (required)
  • OCTOMIND_API_URL - Base URL for the API endpoint to use (defaults to https://app.octomind.dev/api)
  • REDIS_URL - Redis connection URL for session storage (optional, format: redis://host:port)
  • SESSION_EXPIRATION_SECONDS - Time in seconds after which sessions expire (optional, Redis only)

Command Line Options

The server supports the following command line options:

  • -s, --sse - Enable SSE transport mode
  • -t, --stream - Enable Streamable HTTP transport mode
  • -c, --clients - Show client configuration examples
  • -p, --port <port> - Port to listen on (default: 3000)
  • -r, --redis-url <url> - Redis URL for session storage
  • -e, --session-expiration <seconds> - Session expiration time in seconds

Session Storage

The server supports two types of session storage:

  1. In-memory storage (default) - Sessions are stored in memory and will be lost when the server restarts
  2. Redis storage - Sessions are stored in Redis and can persist across server restarts

For production deployments, it's recommended to use Redis storage with an appropriate session expiration time. The Redis storage option also enables horizontal scaling with multiple server instances.

Logging Configuration

  • 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:

bash
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:

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

Claude Desktop (.claude-config.json)

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)

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)

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

Listings / Integrations

Certified by MCPHub

MseeP.ai Security Assessment Badge

Star History

Star History Chart

Repository Owner

OctoMind-dev
OctoMind-dev

Organization

Repository Details

Language TypeScript
Default Branch main
Size 1,229 KB
Contributors 9
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
97.58%
JavaScript
2.05%
Dockerfile
0.37%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • k6-mcp-server

    k6-mcp-server

    A Model Context Protocol server for orchestrating k6 load tests via MCP-enabled clients.

    k6-mcp-server implements the Model Context Protocol, allowing users to execute and manage k6 load testing scripts through standardized MCP clients. It provides a simple API, supports custom test durations and virtual users, and offers real-time execution output. The system is configurable via environment variables and can be easily integrated into existing MCP-compatible tooling.

    • 17
    • MCP
    • QAInsights/k6-mcp-server
  • E2B MCP Server

    E2B MCP Server

    Add code interpretation to Claude Desktop apps with E2B Sandbox.

    E2B MCP Server provides code interpreting capabilities for the Claude Desktop application through integration with the E2B Sandbox. It offers both JavaScript and Python editions for flexibility in development. The solution can be easily installed via the Smithery tool, streamlining setup and integration. The server enables seamless execution and management of code within AI-powered desktop environments.

    • 346
    • MCP
    • e2b-dev/mcp-server
  • OpsLevel MCP Server

    OpsLevel MCP Server

    Read-only MCP server for integrating OpsLevel data with AI tools.

    OpsLevel MCP Server implements the Model Context Protocol to provide AI tools with a secure way to access and interact with OpsLevel account data. It supports read-only operations for a wide range of OpsLevel resources such as actions, campaigns, checks, components, documentation, domains, and more. The tool is compatible with popular environments including Claude Desktop and VS Code, enabling easy integration via configuration and API tokens. Installation options include Homebrew, Docker, and standalone binaries.

    • 8
    • MCP
    • OpsLevel/opslevel-mcp
  • AutoMobile

    AutoMobile

    Powerful tools for mobile automation, test authoring, and device management via MCP.

    AutoMobile provides a comprehensive set of tools for mobile automation, focusing on UI testing and development workflow automation. It operates as an MCP Server, enabling a robust interaction loop for model-driven actions and observations. The solution supports Android platforms with features like automated test authoring, multi-device management, and seamless CI test execution. AutoMobile also offers source mapping and deep view hierarchy analysis to enhance code rendering accuracy.

    • 63
    • MCP
    • zillow/auto-mobile
  • Octagon MCP Server

    Octagon MCP Server

    AI-powered financial research and market intelligence via MCP.

    Octagon MCP Server enables specialized, AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It provides the ability to analyze public filings, earnings call transcripts, financial metrics, stock data, and private market transactions within Claude Desktop and other MCP-compatible clients. The server orchestrates multiple specialized agents for comprehensive market analysis and can aggregate, extract, and structure data from financial sources and public websites. Designed for seamless use in standardized Model Context Protocol environments, it supports rapid integration into advanced AI workflows.

    • 78
    • MCP
    • OctagonAI/octagon-mcp-server
  • locust-mcp-server

    locust-mcp-server

    Run Locust load tests via Model Context Protocol integration.

    locust-mcp-server provides a Model Context Protocol (MCP) server for executing Locust load tests, allowing seamless connection between Locust and AI-powered development environments. It offers easy configuration, real-time test output, and both headless and UI testing modes. The project features a simple API for customizable load testing scenarios and supports various runtime and user parameters.

    • 9
    • MCP
    • QAInsights/locust-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results