> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# TinyFish

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Run a browser automation that finds the cheapest plan on a vendor's pricing page
* Start a batch of automations that check order status across supplier portals
* Fetch a list of URLs and return their content for summarization

## Available Tools

#### run_automation

#### start_automation

#### start_automations_batch

#### create_browser_session

Create a remote browser session and return its Chrome DevTools Protocol (CDP) endpoint. This hands back a raw\...

#### close_browser_session

Close a remote browser session created by create_browser_session, ending its per-minute billing immediately...

#### list_browser_profiles

List saved Browser Context Profiles (persistent logged-in browser state). Use the returned id values for profile_id...

#### fetch_urls

Fetch and extract content from 1-10 URLs. Per-URL failures are returned in `errors` alongside any successful...

#### list_runs

List automation runs with optional server-side filters (status, goal substring, date range) and sorting. Use get_run...

#### get_run

Get full detail for one run, including its steps. Defaults to lean output: screenshots as URLs and HTML omitted. Use...

#### get_runs_batch

Get full detail for up to 100 runs by ID in a single call. Inlined step content is subject to a total size budget...

#### cancel_run

Cancel a pending or running automation run. Has no effect (returns the current status) if the run already finished.

#### cancel_runs_batch

Cancel up to 100 pending or running automation runs by ID in a single call.

#### get_run_step_screenshot

Get the screenshot for one run step as base64-encoded JPEG. Use get_run's steps to find valid run_id/step_id pairs...

#### get_run_step_html

Get the raw HTML snapshot for one run step. Only available if capture_config.html was enabled on the run. Use...

#### search_web

Run a web search and return ranked results. Supports filtering by domain, date range, and recency. Use the page...

#### list_vault_credentials

List vault credential items available to this account. Use the returned id values for credential_item_ids when...

#### get_wallet

Get the current wallet balance, auto-reload configuration, and billing rates for this account.

#### list_fetch_usage

List paginated usage records for the fetch API.

#### list_search_usage

List paginated usage records for the search API. Each record has the query and its result count, not the results...

#### list_browser_session_usage

List paginated usage records for browser sessions, optionally filtered by session_id or status.