TinyFish MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with TinyFish MCP or direct API to run browser sessions, perform live web searches, extract page content, and manage automation runs through natural language.

TinyFish logoTinyFish
Api Key

TinyFish is a web automation platform for browser sessions, live search, and content extraction. Use it to automate research, scrape content, and run repeatable browser workflows.

32 Tools

Try TinyFish now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
TinyFish
Try asking
TOOLS

Supported Tools

Every TinyFish action and event your agent gets out of the box.

Cancel Profile Setup Session

Cancel a Browser Context Profile setup session and permanently discard its unsaved cookies and browser storage.

Cancel Research Run

Cancel one running TinyFish research run using a connected TinyFish account.

Cancel Runs

Idempotently cancel one or up to 100 asynchronous or SSE runs.

Create Browser Session

Create an isolated TinyFish remote browser session and return its CDP connection URL.

Create Monitor

Create a scheduled Page or Topic Monitor and immediately capture its paid baseline using a connected TinyFish account.

Create Profile

Create a reusable Browser Context Profile for cookies and browser storage; this changes persistent account state.

Delete Monitor

Permanently delete a TinyFish Monitor and its schedule using a connected TinyFish account.

Delete Profile

Permanently delete a Browser Context Profile and all browser state saved in it.

Delete Profile Domain

Permanently remove saved cookies and browser storage for one domain from a Browser Context Profile.

Fetch URLs

Render and extract content from 1-10 URLs in one provider-native batch.

Get Monitor

Get one TinyFish Page or Topic Monitor by ID using a connected TinyFish account, including its target config, schedule, lifecycle status, webhook, and last error.

Get Profile

Get one Browser Context Profile and its saved-domain metadata.

Get Research Run

Read one saved TinyFish research run using a connected TinyFish account, including status, partial or final reports, plan, evidence, and iteration count.

Get Runs

Get summary records for 1-100 TinyFish automation run IDs in one request.

Get Wallet

Get the TinyFish wallet balance, auto-reload and pending-top-up state, and current Agent and Browser rates.

List Monitors

List Page and Topic Monitors owned by a connected TinyFish account, including their IDs for management and run operations.

List Profiles

List Browser Context Profiles available to the connected TinyFish account.

List Research Runs

List saved TinyFish research runs with optional status, query, date, and sort filters, returning one cursor-controlled page.

List Runs

List automation runs with optional status, goal, date, and sort filters, returning one cursor-controlled page.

List Usage

List one page of Search, Fetch, or Browser usage history.

List Vault Connections

List display-safe metadata for password-manager vaults connected to TinyFish.

List Vault Items

List display-safe metadata for items synchronized from password-manager vaults connected to TinyFish.

Run Monitor Now

Run an existing Page or Topic Monitor immediately and save its result; managed Instant users must connect their own TinyFish account.

Save Profile Setup Session

Persist cookies and browser storage from a completed setup session into a Browser Context Profile, then clean up the temporary session.

Search Web

Search live web pages, news, or research papers with domain and time filters, optionally fetching result pages inline, and return exactly one caller-selected zero-based result page.

Start Profile Setup Session

Start a billable temporary remote browser session for establishing login state in a Browser Context Profile.

Start Research Async

Start a paid TinyFish research run in the background and return its run ID; managed Instant users must connect their own TinyFish account.

Sync Vault Items

Refresh display-safe item metadata from all password-manager vaults already connected to TinyFish.

Terminate Browser Session

Idempotently terminate a remote TinyFish browser session to stop further browser usage charges.

Update Monitor

Pause or resume a TinyFish Monitor, or edit its schedule and delivery metadata, using a connected TinyFish account.

Update Profile

Rename a Browser Context Profile or change its default and proxy-country settings.

Upload Profile State

Upload cookies and local or session storage directly into a Browser Context Profile.

SETUP GUIDE

Connect TinyFish MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["tinyfish"],
  mcp: true,
});
Create a session scoped to TinyFish and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Extract article content from example.com",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a TinyFish request
SETUP GUIDE

Connect TinyFish API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["tinyfish"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to TinyFish
3

Run TinyFish tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Extract article content from example.com" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the TinyFish tool calls through the session, and print the final answer

Why Use Composio?

AI Native TinyFish Integration

  • Supports both TinyFish MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your TinyFish data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke TinyFish access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access TinyFish
  • Scoped, least privilege access to TinyFish resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with TinyFish.It takes 30 seconds.

Managed auth, hosted MCP servers, and every TinyFish tool your agent needs.Free to start.

Start building