# TinyFish MCP

AI-powered browser automation and web interaction agent. Enables AI to browse, interact with websites, and perform web tasks.

- **Category:** model context protocol
- **Auth:** DCR_OAUTH
- **Composio Managed App Available?** No
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `TINYFISH_MCP`
- **Version:** 20260310_00

## Tools

### Cancel run

**Slug:** `TINYFISH_MCP_CANCEL_RUN`

Cancels a running or pending automation run by its ID. Idempotent: if the run is already in a terminal state (COMPLETED, FAILED, CANCELLED), returns the current status without error. Only PENDING and RUNNING runs will be actively cancelled.

### Discover run

**Slug:** `TINYFISH_MCP_DISCOVER_RUN`

Discovers the currently running automation for this session. Returns runId if a run is active, or null if not yet started.

### Get run

**Slug:** `TINYFISH_MCP_GET_RUN`

Retrieves details of a specific automation run by its ID. Returns status, result, error, and other metadata. IMPORTANT: Call this after run_web_automation errors or times out — the run is likely still executing. If you do not have a run_id, use list_runs to find it. Also use this to poll for completion after run_web_automation_async. Runs typically take a few minutes. Wait 30-60 seconds between polls.

### Get steps

**Slug:** `TINYFISH_MCP_GET_STEPS`

Retrieves the steps taken during an automation run, including screenshots.

### List runs

**Slug:** `TINYFISH_MCP_LIST_RUNS`

Lists automation runs with optional filtering by status and pagination support. Returns an array of runs with their details. Use this to find a recently created run when you do not have its run_id (e.g., after run_web_automation timed out before returning a run_id). Filter by status=RUNNING to find active runs.

### Poll status

**Slug:** `TINYFISH_MCP_POLL_STATUS`

Polls the current status of an automation run. Returns status, step, progress, and other metadata.

### Run web automation

**Slug:** `TINYFISH_MCP_RUN_WEB_AUTOMATION`

Executes web automation given a URL and a Natural Language description of the automation goal to be performed. Automation is mostly focused around navigating complex web pages and extracting data from web pages. Include _meta.progressToken in your request to receive progress notifications. WARNING: This tool may take several minutes. If it errors or times out, the run is STILL EXECUTING on the server. DO NOT call this tool again or call run_web_automation_async — both would create a duplicate run. Instead: if you have a run_id from progress notifications, call get_run. If you have no run_id, call list_runs to find it. Only create a new run after confirming the previous one finished.

### Run web automation async

**Slug:** `TINYFISH_MCP_RUN_WEB_AUTOMATION_ASYNC`

Starts a NEW web automation run asynchronously and returns a run_id immediately without waiting for completion. WARNING: Do NOT use this to retry a failed run_web_automation call — that run is still executing. Use get_run or list_runs to check its status instead. Only use this tool for genuinely new tasks. Workflow: 1) Call this tool to get a run_id. 2) Wait 30-60 seconds. 3) Call get_run with the run_id to check status. 4) Repeat step 2-3 until status is COMPLETED, FAILED, or CANCELLED.