Tinyfish MCP connector

OAuth 2.1/DCRAutomationAIDeveloper Tools

Connect to Tinyfish MCP. Run browser-based web automations, fetch page content, and search the web using a real cloud Chrome browser.

Tinyfish MCP connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “Set your credentials”

Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'tinyfishmcp'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Tinyfish MCP:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'tinyfishmcp_batch_status',
25
  toolInput: { run_ids: [] },
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "tinyfishmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Tinyfish MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={"run_ids":[]},
27
    tool_name="tinyfishmcp_batch_status",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

Search records — Search the web and return structured results with titles, snippets, and URLs
Run web automation async, web automation, discover — Start a single web automation in the background and return the run ID immediately without waiting for completion
Status poll, batch — Return the current status, step count, and progress for an automation run
List runs, fetch usage, browser sessions — List automation runs with optional filtering by status, goal text, and date range, with cursor-based pagination
Get steps, search usage, run — Retrieve the step-by-step execution trace for an automation run, including screenshots captured at each step
Fetch content — Render up to 10 URLs in a real browser and return clean structured content (markdown, HTML, or JSON) plus metadata like title, author, and publish date

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

tinyfishmcp_batch_cancel#Cancel up to 8 running or pending automation runs by their IDs. Already-terminal runs are returned with their current status.1 param

Cancel up to 8 running or pending automation runs by their IDs. Already-terminal runs are returned with their current status.

NameTypeRequiredDescription

run_idsarrayrequiredList of run IDs to cancel or check status for (up to 8).

tinyfishmcp_batch_create#Start up to 8 web automations simultaneously and return all run IDs immediately. Poll progress with batch_status.2 params

Start up to 8 web automations simultaneously and return all run IDs immediately. Poll progress with batch_status.

NameTypeRequiredDescription

runsarrayrequiredArray of 1–8 run configurations to start simultaneously.

profile_idstringoptionalBrowser profile ID to use when use_profile is true.

tinyfishmcp_batch_status#Check the status, result, and error for up to 8 automation runs by their IDs.1 param

Check the status, result, and error for up to 8 automation runs by their IDs.

NameTypeRequiredDescription

run_idsarrayrequiredList of run IDs to cancel or check status for (up to 8).

tinyfishmcp_cancel_run#Cancel a running or pending automation run by its ID. Returns current status without error if the run has already reached a terminal state.1 param

Cancel a running or pending automation run by its ID. Returns current status without error if the run has already reached a terminal state.

NameTypeRequiredDescription

idstringrequiredThe unique run ID to retrieve or cancel.

tinyfishmcp_create_browser_session#Create a remote stealth Chrome browser session in the cloud and return CDP connection details (session_id, cdp_url) for use with Playwright, Puppeteer, or Selenium. Sessions auto-terminate after the configured inactivity timeout.2 params

Create a remote stealth Chrome browser session in the cloud and return CDP connection details (session_id, cdp_url) for use with Playwright, Puppeteer, or Selenium. Sessions auto-terminate after the configured inactivity timeout.

NameTypeRequiredDescription

timeout_secondsintegeroptionalBrowser session timeout in seconds.

urlstringoptionalTarget website URL to automate.

tinyfishmcp_discover_run#Return the run ID of the currently active automation for the given session, or null if no run is in progress.1 param

Return the run ID of the currently active automation for the given session, or null if no run is in progress.

NameTypeRequiredDescription

session_idstringrequiredThe browser session ID to look up the running automation for.

tinyfishmcp_fetch_content#Render up to 10 URLs in a real browser and return clean structured content (markdown, HTML, or JSON) plus metadata like title, author, and publish date. Fetches run in parallel; per-URL errors are reported without blocking the rest.6 params

Render up to 10 URLs in a real browser and return clean structured content (markdown, HTML, or JSON) plus metadata like title, author, and publish date. Fetches run in parallel; per-URL errors are reported without blocking the rest.

NameTypeRequiredDescription

formatstringrequiredOutput format for extracted content. Accepted values: markdown, html, json.

image_linksbooleanrequiredSet to true to extract all image URLs from each page.

include_html_headbooleanrequiredSet to true to return a full HTML document with <head> when format is html.

linksbooleanrequiredSet to true to extract all hyperlinks from each page.

urlsarrayrequiredList of URLs to fetch content from.

ttlintegeroptionalCache TTL in seconds for fetched content. Omit to disable caching.

tinyfishmcp_get_run#Retrieve status, result, error, and metadata for a specific automation run by its ID.1 param

Retrieve status, result, error, and metadata for a specific automation run by its ID.

NameTypeRequiredDescription

idstringrequiredThe unique run ID to retrieve or cancel.

tinyfishmcp_get_search_usage#List past search usage records with optional filtering by date range and status, for auditing query history and credit consumption.5 params

List past search usage records with optional filtering by date range and status, for auditing query history and credit consumption.

NameTypeRequiredDescription

limitintegerrequiredMaximum number of results to return per page.

pageintegerrequiredPage number for paginated results.

end_beforestringoptionalReturn records ending before this ISO 8601 timestamp.

start_afterstringoptionalReturn records starting after this ISO 8601 timestamp.

statusstringoptionalFilter by run or session status (e.g. completed, failed, running).

tinyfishmcp_get_steps#Retrieve the step-by-step execution trace for an automation run, including screenshots captured at each step.1 param

Retrieve the step-by-step execution trace for an automation run, including screenshots captured at each step.

NameTypeRequiredDescription

runIdstringrequiredThe unique run ID to retrieve steps or poll status for.

tinyfishmcp_list_browser_sessions#List browser sessions with optional filtering by session ID, time range, and status, returning duration, data usage, and connection metadata.6 params

List browser sessions with optional filtering by session ID, time range, and status, returning duration, data usage, and connection metadata.

NameTypeRequiredDescription

limitintegerrequiredMaximum number of results to return per page.

pageintegerrequiredPage number for paginated results.

end_beforestringoptionalReturn records ending before this ISO 8601 timestamp.

session_idstringoptionalThe browser session ID for an active cloud session.

start_afterstringoptionalReturn records starting after this ISO 8601 timestamp.

statusstringoptionalFilter by run or session status (e.g. completed, failed, running).

tinyfishmcp_list_fetch_usage#List past fetch content requests with optional filtering by date range and status. Does not include the fetched text content.5 params

List past fetch content requests with optional filtering by date range and status. Does not include the fetched text content.

NameTypeRequiredDescription

limitintegerrequiredMaximum number of results to return per page.

pageintegerrequiredPage number for paginated results.

end_beforestringoptionalReturn records ending before this ISO 8601 timestamp.

start_afterstringoptionalReturn records starting after this ISO 8601 timestamp.

statusstringoptionalFilter by run or session status (e.g. completed, failed, running).

tinyfishmcp_list_runs#List automation runs with optional filtering by status, goal text, and date range, with cursor-based pagination.7 params

List automation runs with optional filtering by status, goal text, and date range, with cursor-based pagination.

NameTypeRequiredDescription

limitintegerrequiredMaximum number of results to return per page.

sort_directionstringrequiredSort direction. Accepted values: asc, desc.

created_afterstringoptionalReturn runs created after this ISO 8601 timestamp.

created_beforestringoptionalReturn runs created before this ISO 8601 timestamp.

cursorstringoptionalPagination cursor from the previous response to fetch the next page.

goalstringoptionalNatural language description of what to accomplish on the website.

statusstringoptionalFilter by run or session status (e.g. completed, failed, running).

tinyfishmcp_poll_status#Return the current status, step count, and progress for an automation run.1 param

Return the current status, step count, and progress for an automation run.

NameTypeRequiredDescription

runIdstringrequiredThe unique run ID to retrieve steps or poll status for.

tinyfishmcp_run_web_automation#Execute multi-step web automation on a URL using a natural language goal — clicks, form fills, and navigation. If the tool times out, the run is still executing on the server; use get_run or list_runs to check status.14 params

Execute multi-step web automation on a URL using a natural language goal — clicks, form fills, and navigation. If the tool times out, the run is still executing on the server; use get_run or list_runs to check status.

NameTypeRequiredDescription

goalstringrequiredNatural language description of what to accomplish on the website.

session_idstringrequiredThe browser session ID for an active cloud session.

urlstringrequiredTarget website URL to automate.

agent_configobjectoptionalAgent behavior configuration (max_steps, mode, cursor_style, max_duration_seconds).

api_integrationstringoptionalName of the integration making this call (e.g. zapier, n8n). Used for analytics.

browser_profilestringoptionalBrowser execution profile. Accepted values: lite, stealth.

capture_configobjectoptionalConfigure which data to capture during the run (screenshots, recording, html, etc.).

credential_item_idsarrayoptionalScope vault credentials to specific credential URIs. Requires use_vault to be true.

feature_flagsobjectoptionalFeature flags to enable for this run.

profile_idstringoptionalBrowser profile ID to use when use_profile is true.

proxy_configobjectoptionalProxy configuration for this run (enabled, type, url, country_code).

use_profilebooleanoptionalSet to true to use the default browser profile if profiles are enabled.

use_vaultbooleanoptionalSet to true to include enabled vault credentials for this run.

webhook_urlstringoptionalHTTPS URL to receive webhook notifications for run lifecycle events.

tinyfishmcp_run_web_automation_async#Start a single web automation in the background and return the run ID immediately without waiting for completion. Poll with get_run every 30–60 seconds.14 params

Start a single web automation in the background and return the run ID immediately without waiting for completion. Poll with get_run every 30–60 seconds.