MCP tools
The tools an MCP client (Claude Desktop, Cursor, VS Code, Codex…) sees from kin-browser mcp or a cloud machine's /mcp, in Kin Browser 1.20.1. Every tool takes an optional why. Saved recipes and installed plugins add tools of their own (recipe_<name>, plugin_<name>_<verb>).
open
Open a URL in one of your tabs (p1 unless you name another). Name a space for a new tab to keep a task's tabs together, visible to the person as one named group. Returns the page as elements with refs like e12.
state
Read the page again: every element with its ref. Do this after anything changes.
read
The page as plain text, to quote or summarise. No refs.
find
Only the elements that mention some text, with their refs. Use on long pages.
wait_for
Wait for text to appear, or for the page to settle. Use when a page loads its content after opening.
click
Click an element by its ref from the last page you read.
look
Read the text on screen from the pixels (OCR), with where each piece is, for things the page does not list as elements: text in images, canvases, custom widgets. Optionally only pieces containing some text. Positions are what click_at takes.
extract
The page's data as JSON rows: its tables (with headers), lists, key–value pairs, and repeated cards such as a product grid or results list (title, lines, price, link). Optionally only blocks mentioning some text, or one kind. Use this instead of parsing read() text.
hover
Move the pointer over an element by ref, for menus that only open on hover.
scroll_to_end
Scroll down until the page stops loading more, for long and endless pages. Then read, find or extract.
ask_human
Ask a person for something you must not or cannot do (a sign-in, a captcha, a payment, a confirmation), or a question only they can answer. Give choices for them to pick one, or input: "text" (or "secret", for a code) for a typed answer, and wait (seconds, up to 300) to get the answer back in this call. Otherwise get it later with human_answer. Your page actions are refused until they answer or say it is done.
human_answer
The person's answer to your last ask_human, or that they have not answered yet. wait up to 300 seconds for it.
session
Whether this browser is signed in to a site, judged from its sign-in cookies (names only, never values). With ask: true, if it is not, the site is opened and a person is asked to sign in for you; check again after.
watch
Have Kin Browser check a page every N minutes (default 15, at least 5) without you, and fire when some text appears (or is gone), or an item's price (match) goes below or above a number. A webhook (https) is called when it fires, to wake you or your system. Stops after firing once unless repeat. Check results with watches.
watches
Your watches: what each watches, and the last check (whether it fired).
unwatch
Stop one of your watches, by id.
network
The JSON data this page fetched in the background (its own API answers), newest first, with their addresses: often the cleanest, complete form of a list or search result. Optionally only answers whose address or data mention match. Read-only.
recipes
Saved recipes: tasks recorded once that worked, each callable by name with parameters (they are also listed as recipe_
recipe
Run a saved recipe by name, with its params. Each step finds its element again on the live page; it stops and says where if the site changed.
save_recipe
Save a recording (recording: "last" for the newest) as a recipe with a name and description. params turns values it typed into parameters: {name, step} (and field, the label, for a step that filled a form). Recording must have been on while the task ran.
cite
Evidence for a fact: give the text (or a ref) as it is on the page; returns the quote, the address, the time, and a picture of just that part of the page.
changes
What changed on the page since you last read it: elements added (+), removed (-) and changed (~). Cheaper than reading it all again. Any page tool also takes view: "changes".
fill_form
Fill a form in one step by its fields' labels: {"Full name": "…", "Email": "…", "Country": "Malaysia", "I agree": true}. Text for boxes, an option for dropdowns, true/false for checkboxes. Never submits: says what it filled and what the page says is wrong; then click submit yourself.
open_many
Open up to 8 pages at once and read each — read: "extract" (default, with optional text and fields), "text" or "state" — then close them. For comparing many products, listings or articles quickly.
list_files
What is in a folder on this computer (path, like ~/Documents/specs; depth 1-3). The first time, a person is asked in Kin Browser to allow that folder: if the answer is "a person has been asked", wait a minute and try again. Keys, secrets and Kin Browser's own data are never opened.
read_file
A file on this computer (path): text, or a PDF, Word, Excel or PowerPoint file read as text and tables. Needs a person's yes for its folder, like list_files.
save_file
Save text (a report, a CSV, notes) as a file on this computer. A name alone (report.md) goes in the person's save folder (Downloads unless they chose another), with no question; a whole path elsewhere needs their yes for saving there, asked separately from reading. overwrite: true to replace a file.
send_to
Send results where the person works, only to what they connected in Kin Browser: to "notion" (a page under page from title and text, or rows into a database), "airtable" (base, table, rows), "sheets" (spreadsheet, rows) or "webhook" (name, then text, rows or data). Ultra.
save_document
Make a spreadsheet, document, slides or CSV and save it on this computer: path ending .xlsx, .docx, .pptx or .csv (a name alone goes in the person's save folder); sheets (rows of cells; "=SUM(B2:B9)" is a formula) for xlsx, blocks (heading, paragraph, bullets, table) for docx, slides (title and bullets) for pptx, rows for csv. Ultra.
folder_watch
Watch a folder on this computer: each new file put in it (matching pattern, like "*.pdf") starts a task with goal and the file's path, every every minutes; save "pdf" keeps each report. action add, list, pause, resume, remove. Reading the folder needs the person's yes. Ultra.
read_document
The text and tables of a file a download returned (its path): PDF, Word, Excel, PowerPoint, CSV, text, HTML, or a picture by OCR.
budget
Set limits for this task — steps, minutes, sites — counted from now. When one is reached, a person is asked whether you may continue. A person's own limits always apply too.
note
Leave a short note about the current site (or url) for the next agent and the person: how to get around it, what to watch out for. Notes come back when the site is opened.
notes
Notes left about the current site (or url), or every site.
forget_note
Remove a note that is wrong, by id.
expect
Check something about the page, waiting up to timeout ms (default 5000): text shown (or gone); an element by ref or role+name in a state (visible, hidden, enabled, disabled, checked, unchecked) or with a value; url or title containing text; or how many match (count). Returns pass true/false with what was there.
logs
The page's console errors and warnings, uncaught script errors, and failed (4xx/5xx) or slow (>2s) requests, new since you last asked (since: "all" for everything).
report
A bug report for a developer: the steps you took, a screenshot, the errors and failed requests, and the environment, as Markdown (and saved as a folder with HTML).
visual
Compare the page with its saved baseline picture by name (saved the first time, or with update: true). Returns pass, % of pixels changed, and a diff picture. ignore lists text whose areas change by design (dates, ads).
sweep
Pictures of a page (url, or yours) at many screen sizes in one call — devices (phone-small, phone, phone-large, android, tablet, tablet-landscape, ipad-pro, laptop, laptop-hd, desktop, wide, or all) and your own sizes ("1280x800"), landscape, fullPage, theme light|dark|both, format png for a user manual, current to picture your tab as it is now (a menu open, signed in) without reloading. Saves a contact sheet and reports layout problems by element: wider than the screen, text under 12px, tap targets under 24px.
crawl
Walk a site from url (depth default 2, max pages default 50): broken links, 4xx/5xx pages, pages with script errors, slow and untitled pages.
a11y
Accessibility problems on the page: images without alt text, unnamed buttons and links, unlabelled fields, low text contrast, heading order, language, duplicate ids.
export_test
A recording (recording, default "last") or recipe as a Playwright test file (language: typescript, javascript, python), with role-and-name locators. Returns the code.
save_state
Save this browser's sign-ins (cookies) under a name, to start later tests already signed in. Never returns the cookies.
load_state
Sign in from a saved state by name.
reset_state
Sign out of everything (test browsers only, never a person's window).
conditions
Test under a bad network: preset offline, slow-3g, fast-3g, or none to go back; or latency in ms per request.
mock
Answer the page's requests whose address contains url with status and json (or body), to test error and empty states. Only where a person started Kin Browser with --allow-mock.
unmock
Stop mocking an address (or all).
perf
How fast the page loaded: time to first byte, FCP, LCP, CLS, load, requests, KB transferred, the largest and slowest files, with good/poor verdicts.
compare
Two pages side by side (a and b, e.g. staging and production): text only one has, elements only one has, and with visual: true a picture diff.
request
An HTTP request (GET by default; json or body to send) with this browser's own sign-in, to an address you may open. Returns status, key headers and the data. Redirects are reported, not followed.
fake_data
Realistic test data: a kind (person, company, address, card) for a country (MY, SG, US, GB), count of them, or invalid: true for edge-case values. In fill_form, values like "{{fake.email}}" are filled with one consistent person.
inbox
Emails the app under test sent to Kin Browser's test inbox, newest first, with codes and links picked out. to an address, wait seconds for one to arrive.
trace
Record a Playwright trace: action: "start", then "stop" saves it; open with npx playwright show-trace.
research
A one-page brief on a company (target: its website, or its name to look up): what it offers, hiring, recent news, people and titles named, contacts — every fact numbered to its source page. For sales call prep.
enrich
A company's details from its own website — name, description, phone, email, address, social links — each with the page it came from. For filling CRM records.
leads
Companies listed on a directory, marketplace or exhibitor page, as rows (fields, default name, website, category, location, phone, email), across pages, duplicates removed; also saved as CSV.
watch_signals
Watch a company's careers, pricing, news (and products) pages for buying signals: new roles and stories as new items, pricing and product pages as changes. webhook is told.
watch_new
Watch a list — tenders, jobs, reviews, listings — and fire when new items appear, optionally only ones mentioning keywords. Checked every every minutes (default 360).
track
Track competitors' pages (urls) under a name: each check says what text was added or removed and which prices moved. Daily by default; a digest gathers them.
seo
An SEO audit of a site from url (depth, max pages): titles, descriptions, h1s, canonicals, noindex, structured data, Open Graph, alt text, thin and duplicate pages, error pages, speed. A fix-first list and a CSV.
serp
Search results for a query as a searcher in a country and language sees them (Bing by default; duckduckgo or google, with a fallback when one asks for a captcha), with a screenshot, and where domain ranks.
campaign_check
Pre-launch check of a landing page: UTM tags, links, title and description, a form or call to action, tracking tags firing, consent notice, speed, phone layout, accessibility. Pass/fail per check.
proof
Proof that text shows on each of urls (an ad, a listing, a price): found or not, with a dated screenshot of each, as a report.
reviews
Reviews on a page (url, or your open page) as rows — rating, author, date, text — with the average and the low ones (1–2) flagged. Draft replies with propose.
crm
Put findings in the team's CRM (HubSpot, Salesforce, Zoho, Pipedrive or Odoo, connected by a person): action upsertContact {email, name, phone, company, title}, upsertCompany {name, domain, phone, address}, createDeal {name, amount, stage}, addNote {text, email|company}, createTask {subject, due, email}, attach {path of a report/CSV, email|company}, or find.
ticket_note
An internal (private) note on a support ticket in Zendesk, Freshdesk, Jira Service Management or Intercom: your reproduction text, with a report folder (from report) attached.
schedule_recipe
Run a saved recipe on a timing (every minutes or dailyAt), telling the webhook always, when what it shows changed, or when it fails. For portals without an API.
monitor
Check a user journey every few minutes — a url and the text it must show (expect), or a recipe — and tell the webhook when it breaks (with a picture) and when it recovers.
lookup
Look something up with a template: a parcel with J&T, Pos Laju, DHL or FedEx (template from templates, value the tracking number). Returns the page text, tables and a screenshot.
as_customer
See a page as a customer does, in a separate browser: their saved sign-in (state), device and locale, optionally after a recipe. Returns a screenshot, the text and any errors.
batch
The same action (verb with args, where {{column}} is each row's value) for each of rows, in the background; approve none, batch (a person says go once) or each; fleet: true spreads the rows over this machine's fleet. Check with batch_status.
batch_status
Progress and results of a batch, by id.
batch_cancel
Stop a running batch after the current row.
digest
A plain-language digest of the last hours (24): watches that fired, new items, pages that changed, prices that moved, journeys broken or recovered, drafts waiting. Sent to webhook when given.
propose
Propose a draft (a review reply, a message, a post, an email) for a person to approve or edit before anything is sent. Read the decision with proposals; send only the approvedText.
proposals
Your drafts and their status: pending, approved (with the approved text), rejected (with why).
templates
Ready-made work by role (sales, marketing, crm, support): competitor pricing, tenders, hiring signals, review monitor, uptime, SEO audit, campaign QA, daily digest, parcel lookups.
use_template
Set up a template by id with its values (e.g. {url, webhook}).
check_article
Check a help-centre article: its links work, and (with product, the page it describes) the buttons and menus its steps name are still there.
audit
What agents collected on this machine, from where, by whom (the compliance log).
sign_in
Sign in on the open page's site with a sign-in a person saved in Kin Browser's vault (and its two-factor code). You never see the username, password or code. A person may be asked to allow it. Pass username when the vault has several for the site.
workspace
Google Workspace or Microsoft 365, connected by a person. action sheetsAppend {spreadsheetId (or url) | table+itemId, range, rows}, driveUpload {path of a report/CSV Kin Browser saved, name, folder}, sendEmail {proposal: an approved draft id, to, subject} — only an approved draft, once — or calendarEvent {title, start, end, attendees, description}.
plugin
Run a verb from a plugin a person installed (kin-browser plugins list shows them): name, verb, args.
automate
An automation: when {kind: webhook | watch (job: a watch id) | email (to) | schedule (every minutes or dailyAt)}, run steps [{verb, args}] with {{event.…}} and {{steps.N.…}} filled in; approve asks a person each time. A webhook automation returns its hook path and key.
automations
Your automations, their triggers and their last runs.
unautomate
Remove an automation by id.
annotate
A picture of your tab with numbered boxes on elements (refs: [{ref, label?}]), for a manual step, a bug report or evidence. mask hides elements by ref; hidePersonal hides every email, phone and ID number on screen; fullPage for the whole page.
manual
A user guide from a recording (recording, default the last) or a recipe: each step in words, with a picture and the thing to press boxed and numbered; HTML, Markdown and PDF, in languages en, ms, zh. device: "phone" for a phone guide; scale 2 for sharp pictures.
export_video
A recording as a GIF (default) or format: "webm" video, with each step's words under its picture. For tutorials, bug reports, demos.
repair_recipe
When a recipe stopped because its site changed: find what does that step's job now, then point the step at it by ref. A person approves before it is saved; the old version is kept.
score
Performance, accessibility, SEO and best-practice scores (0–100) for a page, with what to fix first and the change since the last score of that page.
profiles
The saved form profiles (company details and the like), by name and field. Use one with fill_form profile.
task
Hand a whole goal to Kin Browser's own model (Claude): it plans and takes the steps itself with the recipes and what is known about each site, and answers with sources. Runs in the background: wait up to 110 s, then poll tasks with its id. Caps: maxSteps, maxMinutes, maxTokens, maxUsd. Needs a Claude API key on this machine (kin-browser ai key).
tasks
Goal-driven tasks with their status, answer, steps, tokens and US$ spent, time, and tokens saved by reading pages as refs. One by id (wait for it to finish), cancel one, or the list with totals.
site_memory
What agents learned about a site before: its main links and search box, where and how to sign in, notes about its quirks, and the recipes that start there. Read it before working a site out from scratch.
handoff
A CAPTCHA or bot check blocks the page (open says wall): hand this step to a person, who solves it from their phone or the Grid; wait up to 600 s, then read the page again. to hands it to one teammate.
board
The task board agents split work on. add cards (title; one per line), claim the next open one (locked to you for 15 minutes; renew while working), then done with a result, fail, or release it. list shows who holds what. Use as for your name when agents share a space.
write_test
A kin.yaml end-to-end test from a plain description of a flow (description, start url): Claude walks it, the walk becomes a test with checks, the test runs and is fixed until it passes. Background: see it with tasks (the file is in extra).
api_contract
The JSON API calls a page makes. record them as a named contract (endpoints, response shapes, timings); on the next release check against it: fields removed or retyped, errors, endpoints slower than before.
load
Load-lite: one journey (a kin.yaml test file, or a url) run by up to 20 headless browsers at once, rounds times; p50/p95 per step and the failures. Only your own app (an --allow-local address or a host in the team policy).
a11y_fix
Accessibility problems on the page, each with the exact fix: the element's markup before and after, or a CSS rule for contrast. format: "comment" for a PR comment.
dashboard
Price and competitor dashboards: charts over time from the watches and tracking jobs' runs. make (name, optional jobs), share for a link, unshare, remove, or list.
portals
The Malaysian government portal packs (LHDN MyInvois and MyTax, SSM, KWSP, PERKESO) and the jobs each can do.
portal
Run a portal pack's job (name, action, params) as a goal-driven task: read only, signed in from the vault, company details from the "company" form profile. Background: see it with tasks.
teach
Learn a task from the person: start (url, name) opens a teaching tab they do it in; stop turns what they clicked and typed into a recipe, with what they typed as parameters (never a password). Offer it when they would rather show than explain.
smart_watch
A watcher with judgment: pages looked at every everyMinutes, and only changes that matter to about (in words: "price changes, new models") are told, to a webhook or WhatsApp. add / list / run / remove.
handover
Hand your work to another agent: pack (goal, note) keeps your pages, sign-ins and where you got to, as a card on the board; another agent takes it by id and continues where you stopped.
explore
An exploratory tester for a web app (url): it tries flows and odd input in the background and reports bugs with replays and a suggested test (see tasks
browser_matrix
The same page in Chromium, Firefox and WebKit at each size, each compared with Chromium: where browsers render it differently.
mock_contract
Answer the page's API calls from a recorded API contract (name), so the front end runs without its backend. Needs mocking allowed (--allow-mock).
price_index
A Malaysian e-commerce price index: add items (search words) and shops (shopee, lazada, zalora, or name=https://…{q}), then run daily: the cheapest match per shop, promotions and stock, charted.
grants
New grants and incentives from MDEC, MIDA, SME Corp (and urls), matched to the company profile's industry and keywords, with deadlines on the calendar (calendar).
supplier_check
Due diligence on a supplier (name, website): its website, search results for scams and lawsuits, and SSM registration, as one cited report with red flags and a recommendation. Background.
support_draft
A support reply: the customer's message (text) answered with facts looked up (read only) in the portal (orderUrl), cited, saved as a draft for a person to approve. Background.
exec_brief
The weekly executive brief from everything Kin Browser watched (prices, mentions, tenders, grants, tasks), in English and Malay; send emails it to your own domain only. Background.
save_task
Keep a finished task as a recipe (id, name): what was typed becomes parameters, and the next run is a replay with no model.
schedule_goal
A goal on a timing: daily at HH:MM, on a weekday, or everyMinutes. Each run is a task; what changed in the answer since last time goes to a webhook or WhatsApp.
goals
The scheduled goals and their last runs; remove, pause, resume or run one by id.
triage_visual
After a visual check failed (name): is the change intended, a regression or noise, and why. acceptIntended makes an intended change the baseline.
region_check
Open a page (and expect some text) from this machine and every fleet machine at once: up or down and how long, by country, kept for uptime and a map.
replay
Session replay: start keeps a picture after each step and every request; a bug report then includes a scrubbable replay; stop writes it on its own.
tenders
New tenders on tender boards (urls, keywords): title, reference and closing date; calendar puts each closing date on the connected calendar, once.
invoices
Vendor invoices: add a portal (name, url), then collect a month: signed in from the vault, downloaded, saved to the drive, and with match checked against MyInvois. Background: see it with tasks.
listen
Social and review listening: add pages (urls, keywords, alertAt), then run: new mentions with their sentiment, and an alert when too many are negative.
enrich_sync
Keep the CRM's company records fresh: each run enriches a slice of the domains (or a csv) from their websites and updates only the ones that changed.
meeting_prep
Briefs on the outside companies in the next hours (24) of meetings on the connected calendar, each line with its source. send emails each pack to the people on our side (own domain only), once per meeting.
usage
What agents did on this machine over days (30): steps, pages, failures, rows collected, decisions, time, by day and by verb.
click_at
Click at a point in the visible page, in the coordinates look and screenshot use. Only for something no ref reaches: prefer click with a ref.
type
Replace the contents of a field, by ref.
select
Choose an option in a dropdown, by ref.
press
Press a key or chord, such as Enter or Control+A.
scroll
Scroll the page up or down.
back
Go back one page, keeping your place in a list of results.
screenshot
A picture of the visible page, in the same coordinates click_at takes.
download
Click a ref that downloads a file. Returns where it was saved.
upload
Put a file into a file field, by ref. Only a path that a download in this session returned.
pages
The tabs you hold, with their labels, titles and URLs.
close_page
Close one of your tabs.
close
Close all of your tabs when the task is done. The person’s own tabs stay open.
dialog
How the next alert, confirm or prompt on your tab is answered: accept (OK, with text for a prompt) or dismiss (Cancel). Call it before the step that brings the dialog up; without it, confirm and prompt are Cancelled and the result says what was asked.
steps
Run several page actions in order in one call — click, type, select, press, scroll, fill_form, dialog… — stopping at the first that fails, then read the page once (then: state, changes or none). Each step is {tool, args}, as you would call that tool alone. Use it when the page you just read is enough to plan the next few actions.