API and Tool Reference

Use this page as the structured starting point for all MCP tool docs.

Quick Reference

Tool	Primary Purpose	Entry Doc	Executable Examples
Observe	Read browser logs, requests, errors, and captured state	Observe	Observe Examples
Analyze	Run audits and deeper analyses (performance, accessibility, security)	Analyze	Analyze Examples
Interact	Navigate pages and perform browser actions	Interact	Interact Examples
Configure	Manage sessions, noise rules, persistence, and recorder settings	Configure	Configure Examples
Generate	Produce reproductions, reports, and tests from captured data	Generate	Generate Examples

Common Parameters

These parameters appear repeatedly across Gasoline tools:

Parameter	Purpose
what	Selects the mode/action to execute
tab_id	Targets a specific browser tab
timeout_ms	Sets bounded waiting time for operations
summary	Returns compact output for faster triage
correlation_id	Links async actions, follow-up polling, and evidence

Readthedocs-style Navigation

1. Start with Getting Started for setup.
2. Open one tool page and skim the parameter table first.
3. Use guides for workflow patterns:
   • Debug Web Apps
   • Demo Scripts
   • API Validation
   • Automate and Notify
4. Validate behavior with generated markdown endpoints (*.md) for agent parsing.

Agent-friendly Formats

Each docs, blog, and articles route has a markdown endpoint:

• HTML: https://cookwithgasoline.com/guides/debug-webapps/
• Markdown: https://cookwithgasoline.com/guides/debug-webapps.md

Catalogs:

• /llms.txt
• /llms-full.txt