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.

23 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 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 Profile

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

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 Profile

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

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 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.

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.

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 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/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

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

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for TinyFish
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect TinyFish API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute TinyFish Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute TinyFish actions with your Agent

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 OAuth handling with automatic token refresh and rotation
  • 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

Yes, TinyFish requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your TinyFish connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Create the key in your TinyFish account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the TinyFish actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside TinyFish at any time.

When you connect a TinyFish account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in TinyFish as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside TinyFish. If TinyFish lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside TinyFish at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each TinyFish connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment TinyFish rejects the old key. Create a new key in TinyFish and reconnect the account from the Composio dashboard or by asking your agent to reconnect TinyFish. Nothing else changes.

Composio's free plan includes 100,000 tool calls per month with no credit card, which covers most personal TinyFish use. Paid plans add higher limits and team features. Your TinyFish plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple TinyFish accounts).

With Composio, you connect TinyFish once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with TinyFish.It takes 30 seconds.

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

Start building