Qampanion MCP Server

Qampanion ships an MCP (Model Context Protocol) server. AI clients connect to it and call Qampanion tools.

Connection modes

The server supports two transports.

stdio (default)

The AI client launches the binary and talks over stdin/stdout. Use this mode for one user on the same Mac.

{
  "mcpServers": {
    "qampanion": {
      "command": "/Applications/Qampanion.app/Contents/MacOS/QampanionMCP"
    }
  }
}

HTTP

Run the server as a standalone HTTP endpoint. This mode suits a shared Mac mini on a company network: one machine hosts the project, and several teams point their AI clients at the same endpoint.

Start the server:

/Applications/Qampanion.app/Contents/MacOS/QampanionMCP --transport http --host 0.0.0.0 --port 8080

Client config:

{
  "mcpServers": {
    "qampanion": {
      "url": "http://mac-mini.local:8080/mcp"
    }
  }
}

The HTTP transport gives each client its own MCP-Session-Id session. Clients do not share state.

AI Skill

Install the Qampanion skill from Settings → CLI/MCP → Install AI Skill. It lands in ~/.agents/skills/qampanion/ and helps your agent use the tools.

Available Tools

• create_project — Create a new Qampanion project at the specified path.
• get_devices — Get a list of devices available to run tests on.
• get_test_cases — Get a list of test cases from a Qampanion project.
• get_test_case — Get detailed information about a specific test case, including its steps.
• get_test_plans — Get a list of test plans from a Qampanion project.
• get_test_result — Get the saved test result log for a specific test case.
• create_test_case — Create a new test case in a Qampanion project.
• create_step — Create a new step inside an existing test case.
• update_step — Update the description or name of an existing step. Use when a step was created with wrong values.
• delete_step — Delete a step from a test case by ID.
• create_action — Create a new action inside an existing step.
• update_action — Update an existing action in a step. Use when an action was created with wrong values.
• delete_action — Delete an action from a step by ID.
• create_linked_step — Create a new linked step inside an existing test case that references another test case.
• create_network_request_step — Create a new network request step inside an existing test case.
• create_comparison_parameter — Create a new response comparison parameter in an existing network request step.
• create_script_step — Create a new bash script step inside an existing test case.
• create_excluded_zone — Create a new excluded zone in a step (local) or in the whole test case (global).
• update_excluded_zone — Update an existing excluded zone. Use when a zone was created with wrong values.
• delete_excluded_zone — Delete an excluded zone from a test case by ID.
• run_test_case — Run a test case on a device.
• run_test_plan — Run a test plan on a device.
• get_ui_hierarchy — Get the current UI element tree from a running device, with coordinates ready for use in perform_action.
• perform_action — Perform an interactive action (tap, swipe, type, wait) on a running device.
• take_snapshot — Take a screenshot from a running device and save it as the reference snapshot for a test step.
• launch_app — Install and launch an application on a device. Supports optional uninstall before install (reinstall mode).