Tinyfish MCP connector

OAuth 2.1/DCR AutomationAIDeveloper 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.

Name Type Required Description

run_ids array required List 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.

Name Type Required Description

runs array required Array of 1–8 run configurations to start simultaneously.

profile_id string optional Browser 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.

Name Type Required Description

run_ids array required List 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.

Name Type Required Description

id string required The 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.

Name Type Required Description

timeout_seconds integer optional Browser session timeout in seconds.

url string optional Target 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.

Name Type Required Description

session_id string required The 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.

Name Type Required Description

format string required Output format for extracted content. Accepted values: markdown, html, json.

image_links boolean required Set to true to extract all image URLs from each page.

include_html_head boolean required Set to true to return a full HTML document with <head> when format is html.

links boolean required Set to true to extract all hyperlinks from each page.

urls array required List of URLs to fetch content from.

ttl integer optional Cache 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.

Name Type Required Description

id string required The 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.

Name Type Required Description

limit integer required Maximum number of results to return per page.

page integer required Page number for paginated results.

end_before string optional Return records ending before this ISO 8601 timestamp.

start_after string optional Return records starting after this ISO 8601 timestamp.

status string optional Filter 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.

Name Type Required Description

runId string required The 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.

Name Type Required Description

limit integer required Maximum number of results to return per page.

page integer required Page number for paginated results.

end_before string optional Return records ending before this ISO 8601 timestamp.

session_id string optional The browser session ID for an active cloud session.

start_after string optional Return records starting after this ISO 8601 timestamp.

status string optional Filter 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.

Name Type Required Description

limit integer required Maximum number of results to return per page.

page integer required Page number for paginated results.

end_before string optional Return records ending before this ISO 8601 timestamp.

start_after string optional Return records starting after this ISO 8601 timestamp.

status string optional Filter 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.

Name Type Required Description

limit integer required Maximum number of results to return per page.

sort_direction string required Sort direction. Accepted values: asc, desc.

created_after string optional Return runs created after this ISO 8601 timestamp.

created_before string optional Return runs created before this ISO 8601 timestamp.

cursor string optional Pagination cursor from the previous response to fetch the next page.

goal string optional Natural language description of what to accomplish on the website.

status string optional Filter 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.

Name Type Required Description

runId string required The 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.

Name Type Required Description

goal string required Natural language description of what to accomplish on the website.

session_id string required The browser session ID for an active cloud session.

url string required Target website URL to automate.

agent_config object optional Agent behavior configuration (max_steps, mode, cursor_style, max_duration_seconds).

api_integration string optional Name of the integration making this call (e.g. zapier, n8n). Used for analytics.

browser_profile string optional Browser execution profile. Accepted values: lite, stealth.

capture_config object optional Configure which data to capture during the run (screenshots, recording, html, etc.).

credential_item_ids array optional Scope vault credentials to specific credential URIs. Requires use_vault to be true.

feature_flags object optional Feature flags to enable for this run.

profile_id string optional Browser profile ID to use when use_profile is true.

proxy_config object optional Proxy configuration for this run (enabled, type, url, country_code).

use_profile boolean optional Set to true to use the default browser profile if profiles are enabled.

use_vault boolean optional Set to true to include enabled vault credentials for this run.

webhook_url string optional HTTPS 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.