@askqa/mcp

MCP server for AskQA — monitor websites with automated tests by chatting with AI.

Setup

Add to your MCP client config (e.g. Claude Code, Claude Desktop, Cursor):

{
  "mcpServers": {
    "askqa": {
      "command": "npx",
      "args": ["-y", "@askqa/mcp"],
      "env": {
        "AUTOQA_API_URL": "https://api.askqa.ai",
        "AUTOQA_API_KEY": "aq_..."
      }
    }
  }
}

Get your API key from askqa.ai after signing in.

Environment Variables

| Variable | Required | Description | | ---------------- | -------- | ------------------------------------------ | | AUTOQA_API_KEY | Yes | Your AskQA API key | | AUTOQA_API_URL | No | API URL (default: http://localhost:8081) |

Tools

| Tool | Description | | ----------------------------- | ------------------------------------------------------- | | list_tests | List all saved tests | | get_test | Get full details of a test | | create_test | Create a test from a template or custom Playwright code | | update_test | Update an existing test | | delete_test | Delete a test (with confirmation) | | run_test | Run a test and wait for results | | get_test_results | Get recent test run results with step details | | get_test_screenshots | Get screenshots from a test run | | list_templates | List available test templates | | screenshot_url | Screenshot a URL and extract page structure | | validate_test | Dry-run custom test code before saving | | schedule_test | Create a recurring schedule for a test | | list_schedules | List all test schedules | | update_schedule | Pause or resume a schedule | | delete_schedule | Delete a schedule | | add_notification_channel | Add a Telegram notification channel | | list_notification_channels | List notification channels | | remove_notification_channel | Remove a notification channel | | test_notification_channel | Send a test notification |

Example Conversations

Check if something is working:

"Is checkout working on my site?"

The AI will call list_tests to find a matching test, then get_test_results to check the latest run.

Create a new monitor:

"Monitor https://example.com — check that the homepage loads and has a sign-in button"

The AI will use screenshot_url to inspect the page, write custom Playwright code, validate_test to verify it works, then create_test and schedule_test.

Debug a failing test:

"Why is my checkout test failing?"

The AI will call get_test_results and get_test_screenshots to analyze the failure.

Privacy Policy

This extension only makes HTTPS requests to the AskQA API. It does not access files on your computer or collect analytics.

For full details, see the Privacy Policy.

Support

• Website: askqa.ai
• Issues: GitHub Issues
• Email: [email protected]

License

MIT