---
title: "TinyFish integration for LuumenAI"
url: "https://www.luumen.ai/integrations/tinyfish/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# TinyFish integration for LuumenAI

Web automation, live search, and browser profiles from the terminal

## What LuumenAI can do with TinyFish

LuumenAI connects to TinyFish with an API token and exposes 23 tools (11 read-only · 5 write · 7 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 23 tools (11 read-only · 5 write · 7 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: AI & automation

## About TinyFish with LuumenAI

Connect TinyFish and Luumen can search the live web, render pages, and pull content from up to ten URLs at once while you stay in the terminal. It also reads your automation runs, research history, wallet balance, and Browser Context Profiles. Changes — creating a profile, starting a setup session, canceling runs — are previewed and approved first.

## Example tools

Read-only (11 in total):

- `TINYFISH_FETCH_URLS` — Render and extract content from 1-10 URLs in one provider-native batch.
- `TINYFISH_GET_PROFILE` — Get one Browser Context Profile and its saved-domain metadata.
- `TINYFISH_GET_RUNS` — Get summary records for 1-100 TinyFish automation run IDs in one request.
- `TINYFISH_GET_WALLET` — Get the TinyFish wallet balance, auto-reload and pending-top-up state, and current Agent and Browser rates.
- `TINYFISH_LIST_PROFILES` — List Browser Context Profiles available to the connected TinyFish account.
- `TINYFISH_LIST_RESEARCH_RUNS` — List saved TinyFish research runs with optional status, query, date, and sort filters, returning one cursor-controlled page.
- `TINYFISH_LIST_RUNS` — List automation runs with optional status, goal, date, and sort filters, returning one cursor-controlled page.
- `TINYFISH_LIST_USAGE` — List one page of Search, Fetch, or Browser usage history.

Write and destructive (12 in total, subject to configured approval policy):

- `TINYFISH_CANCEL_PROFILE_SETUP_SESSION` — Cancel a Browser Context Profile setup session and permanently discard its unsaved cookies and browser storage.
- `TINYFISH_CANCEL_RUNS` — Idempotently cancel one or up to 100 asynchronous or SSE runs.
- `TINYFISH_CREATE_BROWSER_SESSION` — Create an isolated TinyFish remote browser session and return its CDP connection URL.
- `TINYFISH_CREATE_PROFILE` — Create a reusable Browser Context Profile for cookies and browser storage; this changes persistent account state.
- `TINYFISH_DELETE_PROFILE` — Permanently delete a Browser Context Profile and all browser state saved in it.
- `TINYFISH_DELETE_PROFILE_DOMAIN` — Permanently remove saved cookies and browser storage for one domain from a Browser Context Profile.
- `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.
- `TINYFISH_START_PROFILE_SETUP_SESSION` — Start a billable temporary remote browser session for establishing login state in a Browser Context Profile.

## Frequently asked questions

### How does LuumenAI connect to TinyFish?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in TinyFish on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to TinyFish — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/tinyfish/