Configuration

CLI Flags

The MCP server accepts these flags. They are passed as args in your IDE’s MCP configuration (see IDE Setup).

Flag	Description	Default
--api-key <key>	Your organization API key. Required for cloud features (suite storage, execution history, healing pattern DB). Local browser tools work without it.	—
--base-url <url>	Cloud API URL. Only change this for self-hosted deployments.	https://api.fasttest.ai
--headed	Run the browser in visible mode. Useful for debugging — you can watch tests execute in real time.	headless
--browser <type>	Browser engine: chromium, firefox, or webkit.	chromium

Example with all flags:

{
  "mcpServers": {
    "fasttest": {
      "command": "npx",
      "args": [
        "@fasttest-ai/qa-agent",
        "--api-key", "YOUR_API_KEY",
        "--browser", "firefox",
        "--headed"
      ]
    }
  }
}

Project File

FastTest Agent stores a .fasttest.json file in your project root to remember the active project:

{
  "project_id": "abc-123",
  "project_name": "My SaaS App"
}

This file is created automatically the first time you use the test or explore tool with a project name.

Tip

Commit .fasttest.json to version control so your team shares the same project context. When anyone runs tests from this directory, they’ll use the same project automatically.

Browser Sessions

Save browser sessions to skip login flows in future test runs:

> Save the current browser session as "admin"
> Restore the "admin" session

Sessions include cookies and localStorage. They are stored locally at:

~/.fasttest/sessions/{your-org}/

Each session is a JSON file named after the session (e.g., admin.json). You can save multiple sessions for different user roles.

Headed Mode (Debugging)

Pass --headed to watch tests run in a visible browser window. This is useful for:

• Debugging why a test step is failing
• Seeing exactly what the browser sees at each step
• Verifying that self-healing found the right element

In headed mode, the browser opens on your screen and you can watch each click, navigation, and assertion happen in real time.

Cross-Browser Testing

FastTest Agent supports three browser engines via Playwright:

Browser	Flag	Install
Chromium	--browser chromium	npx playwright install chromium
Firefox	--browser firefox	npx playwright install firefox
WebKit (Safari)	--browser webkit	npx playwright install webkit

Install the browser you need, then set the --browser flag in your MCP config. The default is chromium.

Device Emulation

FastTest Agent supports device emulation via Playwright device presets. Pass a device parameter to the test, explore, run, security_audit, or vibe_shield tools:

Test the login flow on iPhone 15

Supported devices include any Playwright device preset — iPhone 15, Pixel 7, iPad Pro, etc. When no device is specified, the default viewport is 1280x720 desktop.

You can also resize the viewport manually with browser_page:

> Resize the browser to 375x812

Environment Variables

Test suites support {{VAR_NAME}} placeholders for sensitive values like passwords, API keys, and tokens. These are resolved from environment variables at execution time.

In your IDE:

Set environment variables in your shell before starting your AI assistant:

export TEST_USER_PASSWORD="secret123"
export STRIPE_TEST_KEY="sk_test_..."

In CI/CD:

Set them as GitHub Secrets or CI environment variables. FastTest Agent auto-detects all {{VAR_NAME}} references in a suite and tracks them as required_variables — the CI integration uses this to generate the correct secrets configuration.

Tip

Always use {{VAR_NAME}} placeholders instead of literal values for credentials when saving test suites. This keeps secrets out of your test definitions and makes suites portable across environments.

Rate Limits

The FastTest Agent API allows 60 requests per minute per API key. This is well above typical usage — a full test run counts as a handful of requests regardless of how many test cases it contains.

Billing Plans

Plan	Test Runs / Month	Projects	AI Suites
Free	50	2	5
Pro	1,000	10	Unlimited
Team	Unlimited	Unlimited	Unlimited

Manage your plan from the Dashboard under Settings → Billing.