On this page
Getting started
Run your first browser task
Have your agent open a test page and send back its title and a screenshot. Then ask it to read a tab you already have open.
Open a test page
Send this prompt to an agent connected through the Mearl Skill or MCP.
Use Mearl to open https://example.com in my browser, tell me the page title, and take a screenshot.
Expected result Your browser opens a new tab. The agent replies with the title Example Domain and a screenshot.
Terminal example
To check from the terminal, open the page with the CLI and print its snapshot. The page title in the snapshot should be Example Domain.
mearl run <<'JS'
const tab = await mearl.tabOpen({ url: 'https://example.com' });
const page = await mearl.pageSnapshot({ tabId: tab.tabId });
console.log(page.snapshot);
JSRead a tab you already use
Open a page you know, then tell the agent its title or URL. This lets you check that it can read the existing page and work in the intended browser profile.
Use Mearl to find the tab titled [your tab title]. Tell me its main heading and list up to three visible items. Keep the page as it is.
Compare the reply with what you see in your tab. For example, on an order page, compare the heading and order IDs.
Explore Mearl
Run mearl guide for the CLI workflow. Also see CLI & TypeScript SDK · MCP
If the task cannot find your browser
Check the local connection first. If the task opened in a different browser, list the connections and give the agent the intended browser name or browserId.
mearl browser_list