MCP Tools Reference

Overview

FastTest Agent exposes 19 tools through the Model Context Protocol (MCP). These tools are available to any MCP-compatible AI coding assistant (Claude Code, Codex, Cursor, VS Code, Windsurf, etc.).

Browser Tools (7) Consolidated Playwright control: navigate, interact with elements, fill forms, observe page state, assert conditions, manage sessions, and control page-level operations. Each tool uses an action parameter for related operations.

Domain Tools (12) Test orchestration: test creation, suite management, execution, exploration, security auditing, vibe shield, GitHub integration, healing, and CI/CD.

Tool Design

Browser tools use an action-based API — each tool groups related operations under a single tool with an action parameter. For example, browser_interact handles clicking, hovering, typing, filling, selecting, and pressing keys. This keeps the tool count manageable while covering all browser operations.

Domain tools follow the same consolidation pattern — list handles projects, suites, and test cases; status handles both execution status and health checks; heal handles both selector healing and healing history.

All browser tools automatically return a page snapshot after each action, so your AI assistant always has current page context.

How Tools Are Called

Your AI assistant calls these tools automatically based on your natural language requests. For example:

“Navigate to https://myapp.com and take a screenshot” triggers browser_navigate then browser_observe.
“Test the login flow on https://myapp.com” triggers test which returns a prompt your AI follows.
“Run the login test suite” triggers run.
“Vibe shield my app at https://myapp.com” triggers vibe_shield.
“Secure my app at https://myapp.com” triggers security_audit.
“Fix this broken selector: #old-button” triggers heal.

Quick Reference

Browser Tools (7)

Tool	Actions	Description
`browser_navigate`	`navigate`, `go_back`, `go_forward`	Navigate to URLs and through browser history
`browser_interact`	`click`, `hover`, `type`, `fill`, `select_option`, `press_key`	Interact with page elements
`browser_form`	`fill_form`, `file_upload`	Fill multiple form fields or upload files
`browser_observe`	`snapshot`, `screenshot`, `console_logs`, `network_requests`	Observe page state
`browser_assert`	`assert`, `wait`	Run assertions or wait for elements
`browser_session`	`save`, `restore`, `login`	Manage browser sessions (cookies, storage)
`browser_page`	`tabs`, `resize`, `evaluate`, `handle_dialog`, `drag`	Page-level operations

Domain Tools (12)

Tool	Description
`test`	Start a test session (returns prompt for AI)
`explore`	Explore an app autonomously
`vibe_shield`	One-command regression safety net
`security_audit`	SAST + SCA + DAST security audit (static, dynamic, or full mode)
`save_suite`	Save/update test cases as a reusable suite (upserts by name, supports security findings)
`run`	Execute a test suite
`list`	List projects (`type='projects'`), suites (`type='suites'`), or test cases (`type='cases'`)
`status`	Check execution status (with `execution_id`) or backend health (without)
`cancel`	Cancel execution
`setup`	Authenticate with cloud (device auth)
`github_token`	Set GitHub PAT
`heal`	Heal broken selector or view healing history (`show_history=true`)