TinyFish MCP for AI agents
Agents read TinyFish MCP at once. Changes and sends are held for a person's approval by default.
About TinyFish MCP
TinyFish MCP lets authorized agents search and fetch live web content, run and inspect browser automations, manage browser sessions and monitors, and review usage and wallet status.
What an agent can do in TinyFish MCP
Every TinyFish MCP action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in TinyFish MCP without asking first. 13 actions.
- Batch statusOnly use after batch_create to poll progress for multiple automation runs. Checks status by ID for up to 8 runs and returns status, result, and error for each. Poll every 30-60s until all runs reach a
- Discover runApp-only tool for discovering the currently running automation for this session. Returns runId if a run is active, or null if not yet started.
- Fetch contentDefault, free, and most token-efficient tool for reading URL(s) and extracting source details. Use when the user provides URL(s), or after search when a grounded answer needs details from a specific s
- Get runOnly use after run_web_automation errors, times out, or returns a run_id that needs polling. Retrieves status, result, error, and metadata for a specific automation run. If you do not have a run_id, u
- Get search usageOnly use when the user asks to review search history, check what queries were made, or audit usage. Never use this to verify whether TinyFish is connected, installed, ready, or working; verify setup b
- Get stepsOnly use when the user asks to inspect how an automation ran. Retrieves the steps taken during an automation run, including screenshots.
- Get walletRead-only. Returns the caller's current wallet balance, auto-reload state, per-product contract rates, and any in-flight top-up. Wallet top-ups and auto-reload changes happen in the dashboard, not thr
- Guide next stepReturns the next interactive TinyFish onboarding step based on the user’s real usage. Ask for the user’s input and wait before running the suggested tool.
- List browser sessionsOnly use when the user asks to check active browser sessions, review browser usage history, or find a specific browser session by ID. Lists sessions with filtering and pagination.
- List fetch usageOnly use when the user asks to review fetch history or audit fetch usage. Never use this to verify whether TinyFish is connected, installed, ready, or working. Lists past fetch_content requests with o
- List runsOnly use when you need to find a run_id for a recently created automation, usually after run_web_automation timed out before returning one. Lists automation runs with optional filtering by status and
- Poll statusApp-only tool for polling the current status of an automation run. Returns status, step, progress, and other metadata.
Show all 13
- SearchDefault, free, and most token-efficient first tool for external knowledge and web grounding. Use for current/today/latest questions, weather, documentation/API setup, public product/company/tool expla
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 7 actions.
- Batch cancelOnly use when the user explicitly asks to stop multiple running or pending automations. Never cancel because runs are slow, still pending, or a status call returned without results — keep waiting inst
- Cancel runOnly use when the user explicitly asks to stop a running or pending automation. Never cancel because a run is slow, still pending, or a wait/poll call returned without a result — keep waiting instead.
- Close browser sessionOnly use when the user explicitly wants to stop or close a remote browser session. Closes a session by ID. Idempotent — already-ended sessions return success.
- Create browser sessionFor direct browser control or visual QA, open a browser session through your wallet account. Close it when you are done so it does not stay open. Default tool for direct Playwright, Puppeteer, Seleniu
- Create monitorUse when the user asks to monitor a webpage for changes or subscribe to updates about a web topic. Set type to fetch for a known URL or search for a topic. Creates the recurring Monitor and immediatel
- Run web automationMetered web automation is available through your wallet — use it for clicking, forms, login, or dynamic pages. Default tool for interactive website tasks when there is one site or workflow, web automa
- Run web automation async⚠️ ONLY call this tool when the user has EXPLICITLY said they want to run the task in the background (e.g. "run this in the background"). DO NOT use this as a default or fallback — use run_web_automat
Changes wait in Needs you
Changes and sends in TinyFish MCP are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
TinyFish MCP questions
Can an agent change data in TinyFish MCP on its own?
Not by default. Changes and sends in TinyFish MCP are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in TinyFish MCP?
This connector lists 13 read actions. Reads run at once, without waiting for approval.
How does TinyFish MCP connect?
It connects with dcr oauth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.