Run the Octomind MCP agent and toolkit inside a Meshagent Room in the cloud:

1. Install Meshagent

pip install "meshagent[all]"

2. Sign Up & Authenticate

Follow the guide: Meshagent CLI - Get Started

3. Start the MCP Server Agent in a Meshagent Room

meshagent service test --room=test --role=agent --image=meshagent/mcp-octomind:latest --env MESHAGENT_PORT=8001 --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" --name=mcp-octomind-service
  • This command creates a Meshagent Room and runs the Octomind MCP server as an agent inside it.
  • Note: Rooms will automatically close if they go inactive.

4. Join with a Chatbot Agent Using the Octomind Toolkit

meshagent chatbot join --room=test --agent-name=sample --name=sample --toolkit=mcp-octomind
  • The chatbot launches in the same room and gains access to the Octomind toolkit.
  • Multiple toolkits can be used by the same agent within a room.
  • The command will output a link to the room UI for real-time interaction.

Tools Available

Tools Summary

  • createEnvironment: Create an environment for a given test target, including test accounts, headers, discovery URLs, and variables.
  • createTestTarget: Create a new test target/project (an application or service under test).
  • deleteEnvironment: Permanently delete an environment for a specific test target.
  • deleteTestTarget: Permanently delete an existing test target.
  • discovery: Generate a test case for a test target, based on a description or prompt.
  • executeTests: Trigger a set of tests for a specified test target.
  • getEnvironments: Retrieve all environments for a given test target.
  • getPrivateLocations: Retrieve all private server locations configured for the organization.
  • getTestCase: Retrieve a specific test case for a test target.
  • getTestReport: Retrieve a test report for a given test target.
  • getTestReports: Retrieve multiple test reports for a test target.
  • getTestTargets: Retrieve all test targets (projects/applications) for the organization.
  • getVersion: Display the current version of the Octomind MCP server.
  • search: Search Octomind documentation for any query.
  • updateEnvironment: Update an environment’s configuration for a test target.
  • updateTestTarget: Update details for an existing test target.

Tool Details

createEnvironment

Creates an environment for a specific test target.

ParameterTypeDescription
discoveryUrlstringURL used for test discovery
namestringName of the environment
testTargetIdstringUnique identifier of the test target
additionalHeaderFieldsobject*Optional additional HTTP header fields
basicAuthobject*Optional basic authentication credentials
privateLocationNamestring*Optional private location name (e.g. if testing behind a firewall)
testAccountobject*Optional test account credentials

createTestTarget

Creates a new test target/project.

ParameterTypeDescription
appstringThe app/project name
discoveryUrlstringThe discovery URL
skipAutomaticTestCreationboolean*Skip automatic test creation

deleteEnvironment

Deletes an environment for a given test target (irreversible).

ParameterTypeDescription
environmentIdstringID of environment to delete
testTargetIdstringID of the associated test target

deleteTestTarget

Deletes a test target (irreversible).

ParameterTypeDescription
testTargetIdstringID of test target

discovery

Creates a test case for a specified test target.

ParameterTypeDescription
namestringName of the test case
promptstringDescription/prompt for test case generation
testTargetIdstringID of test target
assignedTagNamesarray*Optional list of tag names
entryPointUrlPathstring*Optional entry point URL path
externalIdstring*Optional external ID (e.g., ticket or test rail)
folderNamestring*Optional folder name for the test case
prerequisiteIdstring*Optional prerequisite test case ID

executeTests

Triggers tests for a given test target.

ParameterTypeDescription
testTargetIdstringID of test target
urlstringURL for test execution
descriptionstring*Optional description
environmentNamestring*Optional environment name
tagsarray*Optional filter by tags
variablesToOverwriteobject*Optional override variables

getEnvironments

Retrieves all environments for a test target.

ParameterTypeDescription
testTargetIdstringID of test target

getPrivateLocations

Lists all private server locations configured for your organization.

getTestCase

Retrieves a single test case for a test target.

ParameterTypeDescription
testCaseIdstringID of the test case
testTargetIdstringID of test target

getTestReport

Retrieves a specific test report.

ParameterTypeDescription
testReportIdstringID of the test report
testTargetIdstringID of test target

getTestReports

Retrieves test reports for a test target.

ParameterTypeDescription
testTargetIdstringID of test target
filterarray*Optional filters for the report
keyobject*Optional key filters

getTestTargets

Retrieves all test targets/projects.

getVersion

Returns the current version of the Octomind MCP server.

Searches Octomind documentation for a specific query.

ParameterTypeDescription
querystringSearch query

updateEnvironment

Updates an environment’s configuration.

ParameterTypeDescription
environmentIdstringID of environment
testTargetIdstringID of test target
additionalHeaderFieldsobject*Optional extra HTTP header fields
basicAuthobject*Optional basic authentication
discoveryUrlstring*Optional new discovery URL
namestring*Optional new name
privateLocationNamestring*Optional private location
testAccountobject*Optional test account credentials

updateTestTarget

Updates an existing test target/project.

ParameterTypeDescription
testTargetIdstringID of the test target
appstring*Optional new app/project name
discoveryUrlstring*Optional new discovery URL
skipAutomaticTestCreationboolean*Skip initial test creation
testIdAttributestring*Optional attribute for test ID
testRailIntegrationobject*TestRail integration config
timeoutPerStepnumber*Timeout per step (ms)