NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
TinyFish MCP connects to a Nagent workspace. Once it is connected, agents can call 8 TinyFish MCP actions, such as "Get run", "Get steps" and "List runs". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against TinyFish MCP, with input parameters and output schema.
TINYFISH_MCP_CANCEL_RUNCancels 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.
Input parameters
Run ID
TINYFISH_MCP_DISCOVER_RUNDiscovers the currently running automation for this session. Returns runId if a run is active, or null if not yet started.
Input parameters
The session_id from the automation tool call
TINYFISH_MCP_GET_RUNRetrieves 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.
Input parameters
Run ID
TINYFISH_MCP_GET_STEPSRetrieves the steps taken during an automation run, including screenshots.
Input parameters
The run ID to get steps for
TINYFISH_MCP_LIST_RUNSLists 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.
Input parameters
Filter runs by goal text (case-insensitive partial match)
Maximum number of results to return (1-100)
Cursor for pagination (from previous response)
Filter by run status
Filter runs created after this ISO 8601 timestamp
Filter runs created before this ISO 8601 timestamp
Sort order by created_at
TINYFISH_MCP_POLL_STATUSPolls the current status of an automation run. Returns status, step, progress, and other metadata.
Input parameters
The run ID to poll status for
TINYFISH_MCP_RUN_WEB_AUTOMATIONExecutes 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.
Input parameters
Target website URL to automate
Natural language description of what to accomplish on the website
A unique UUID v4 identifying this request. IMPORTANT: You MUST generate a new, random UUID for every single call — never reuse a previous value or the example. Reusing a session_id will break concurrent sessions.
Proxy configuration
Feature flags to enable for this run
Name of the integration making this API call (e.g., "dify", "zapier", "n8n"). Used for analytics.
Browser profile for execution. LITE uses standard browser, STEALTH uses anti-detection browser.
TINYFISH_MCP_RUN_WEB_AUTOMATION_ASYNCStarts 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.
Input parameters
Target website URL to automate
Natural language description of what to accomplish on the website
A unique UUID v4 identifying this request. IMPORTANT: You MUST generate a new, random UUID for every single call — never reuse a previous value or the example. Reusing a session_id will break concurrent sessions.
Proxy configuration
Feature flags to enable for this run
Name of the integration making this API call (e.g., "dify", "zapier", "n8n"). Used for analytics.
Browser profile for execution. LITE uses standard browser, STEALTH uses anti-detection browser.
Agents can call 8 TinyFish MCP actions on Nagent, including "Get run", "Get steps" and "List runs". Get run: Retrieves details of a specific automation run by its ID. Each action is listed on this page with its input parameters and its output.
Get run takes 1 required input: id.