Ghostqa MCP Server

SpecterQA sends AI personas through your application — they look at the screen, decide what to do, and interact like real humans. No test scripts. No

Local serverstdioPython

What is the Ghostqa MCP Server?

SpecterQA sends AI personas through your application — they look at the screen, decide what to do, and interact like real humans. No test scripts. No selectors. You

What it actually does

Traditional E2E tests are brittle. You write selectors, they break. You maintain scripts, they rot. SpecterQA takes a different approach: AI vision models look at your actual UI and navigate it the way a person would.

  • Persona-based testing — -- Define AI users with backgrounds, goals, frustrations, and tech comfort levels. They don't just follow scripts; they react to what they see
  • Vision-powered — -- No selectors, no DOM queries. The AI interprets screenshots like a human would. Catches visual/layout issues that selector-based tests miss entirely
  • YAML-configured — -- Products, personas, and journeys are all YAML files. PMs can read them. No code to maintain
  • Budget enforcement — -- Per-run, per-day, and per-month cost caps. The engine hard-stops if you hit the limit. No surprise bills
  • JUnit XML output — -- Drop --junit-xml results.xml and plug it into any CI system
  • Tiered model routing — -- Haiku for cheap navigation, Sonnet for complex reasoning, optional local Ollama for zero-cost simple actions

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
specterqa_runExecute behavioral tests. Parameters: product (str), level (str, optional), directory (str, optional). Returns a RunReport JSON object.
specterqa_list_productsList all products and their configured journeys. No parameters required.
specterqa_get_resultsRetrieve a previous run report by run_id.
specterqa_initInitialize a new SpecterQA project at a given directory.

How to install the Ghostqa MCP Server

{
  "mcpServers": {
    "ghostqa": {
      "command": "uvx",
      "args": ["specterqa"],
      "env": {
        "ANTHROPIC_API_KEY": "your-value",
        "SPECTERQA_BUDGET": "your-value",
        "SPECTERQA_ALLOWED_DIRS": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
ANTHROPIC_API_KEYCredential the server authenticates with.Yes
SPECTERQA_BUDGETConfiguration value read at startup.Optional
SPECTERQA_ALLOWED_DIRSFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Ghostqa to specterqa run.”
  • “Use Ghostqa to specterqa list products.”
  • “Use Ghostqa to specterqa get results.”

Frequently asked questions

SpecterQA sends AI personas through your application — they look at the screen, decide what to do, and interact like real humans. No test scripts. No selectors. You Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.