Skip to content

MCP tools

Set up your agent

Give your coding agent a Steel browser and the Steel skills, so that it browses and writes Steel code the right way. Learn more

Install the Steel CLI. It signs you in and installs the skills for your coding agents.

curl -fsS https://setup.steel.dev | sh

Or send this prompt to your coding agent, and it does the same:

Read https://setup.steel.dev/install.md and follow it to set up Steel for this coding client.
Then continue my requested task using the installed Steel skill.

Set up your agent →

Steel's hosted MCP server, at https://mcp.steel.dev/mcp, gives an agent tools to start and end sessions, read and act on pages, and read a session's logs and traces. The tools follow the order in which the server registers them. MCP server explains how to connect a client and sign in.

How the tools work

To read a page, the agent calls scrape. To sign in, click or type, it calls session_create, then snapshot to get refs such as e5, then acts on those refs, and calls session_release at the end. The server sends these instructions to each client that connects.

These rules apply to every tool:

  • Results are text. screenshot also returns a JPEG image, and status and cancel return an image when the execution took a screenshot. Text from a web page comes back inside <untrusted-page-content> tags, and the server tells the agent never to follow instructions found there. Page text is cut at 30,000 characters.
  • after makes a change safe to retry. A tool that changes the page takes after, the next value of the previous result. A call with the same after returns the stored result and never runs the change twice.
  • target names an element: a ref from snapshot, such as e5, or a CSS selector.
  • tab names a tab by its ID, such as t1, from session_create, tab or an earlier result.
  • A failed call sets isError on the result. The text of a failed command starts with Failed:, then the error code and message, and often a hint for the next step. Errors lists the codes.
  • navigate, click, hover, type, fill, press_key, select_option, check, drag and scroll return a diff: what changed on the page since the last snapshot.

Sessions

session_create

Starts a cloud browser and returns its session ID, a link to watch it live, its first tab and the first next. The session ends after its time limit, or after 10 minutes without commands. In a client that supports MCP Apps, such as Claude, the result also shows the browser live in the conversation.

ParameterTypeRequiredDescription
use_proxybooleanNoRoute traffic through a Steel residential proxy.
solve_captchabooleanNoLet Steel solve CAPTCHAs automatically.
profile_idstring, a UUIDNoStart from a saved browser profile.
persist_profilebooleanNoSave cookies and storage back to the profile when the session ends.
use_credentialsbooleanNoFill logins saved in Steel credentials on matching pages.
timeout_minutesinteger, 1 to 1440NoHard limit on the session's life. 15 by default, which every plan allows. A longer value than your plan allows fails.
metadataobjectNoLabels to find the session by later with session_list, such as {"task": "checkout"}. Values are strings, numbers or booleans. Up to 50 keys. Session configuration has the rules.

session_live_view

Streams a session to the live browser view that session_create shows in an MCP Apps client. The view calls this tool, and the client does not offer it to the agent. It works only while a headful session is live.

ParameterTypeRequiredDescription
session_idstringYesThe session to stream.

session_list

Lists the live sessions that this MCP server created in your project. Each line shows a session's ID, status, release reason, creation time, the client that created it, signals and metadata. The newest session comes first. Read-only.

With a filter on metadata, signals, release_reason, created_after or created_before, it searches every session in the project, live and released, unless status is set.

ParameterTypeRequiredDescription
allbooleanNoInclude sessions not created through MCP.
statuslive, released, or failedNoOnly sessions in this state. live by default when no filter is set.
metadataobjectNoOnly sessions whose metadata has all of these exact values.
signalsarray of 1 to 10 signal namesNoOnly sessions that carry all of these signals. Signals can arrive after a session ends, so a live session may not have them yet.
release_reasonuser_requested, timeout, inactivity_timeout, creation_timeout, startup_failed, browser_closed, or browser_crashedNoOnly sessions that ended for this reason.
created_afterstring, an ISO 8601 timeNoOnly sessions created at or after this time.
created_beforestring, an ISO 8601 timeNoOnly sessions created before this time.
limitinteger, 1 to 50NoHow many sessions to return. 20 by default.
cursorstring, a UUIDNoThe cursor from a previous result, to list the sessions after it.

session_release

Ends a session and stops its billing. Its tabs and refs stop working. Calling it again on the same session is safe. The second call says that the session has ended.

ParameterTypeRequiredDescription
session_idstringYesThe session to end.

Web

scrape

Opens a URL in a fresh cloud browser and returns the page as Markdown, with its URL and title. No session is needed, and nothing is left running. Read-only.

ParameterTypeRequiredDescription
urlstring, a URLYesThe page to read.
use_proxybooleanNoRoute traffic through a Steel residential proxy.

Page

Every tool in this section takes session_id, the session to act on. The session must be live. Names in the CLI and the MCP server maps each tool to the command that it sends.

Opens url in the tab, or goes back, goes forward or reloads. Give either url or action.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
tabstringYesThe tab, such as t1.
urlstringNoThe URL to open.
actionback, forward, or reloadNoWhat to do instead of opening url.

snapshot

Returns the page as an accessibility tree, with refs such as e5 for the elements that the agent can act on or point to. Read-only.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
tabstringYesThe tab, such as t1.
interactivebooleanNoOnly list the elements that have a ref.
compactbooleanNoDrop structure that holds no content.
depthinteger, at least 0NoLimit how deep the tree goes.

click

Clicks the element, or double-clicks it with double.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
targetstringYesA ref or a CSS selector.
doublebooleanNoDouble-click instead.
tabstringNoThe tab, such as t1.

hover

Moves the mouse over the element, for menus and tooltips.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
targetstringYesA ref or a CSS selector.
tabstringNoThe tab, such as t1.

type

Types text key by key, as a person would.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
targetstringYesA ref or a CSS selector.
textstringYesThe text to type.
clearbooleanNoClear the field first.
submitbooleanNoPress Enter after typing.
tabstringNoThe tab, such as t1.

fill

Sets the value of one or more fields in order. It stops at the first field that fails.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
fieldsarray of 1 to 50 objectsYesEach object has target, a ref or a CSS selector, and value, a string.
tabstringNoThe tab, such as t1.

press_key

Presses a key or chord, such as Enter, Escape, ArrowDown or Control+a, on target or on the focused element. When a dialog is open on the tab, Enter without target accepts it, and Escape dismisses it.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
keystringYesThe key or chord.
targetstringNoA ref or a CSS selector.
tabstringNoThe tab, such as t1.

select_option

Selects options by value or by label in a select element.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
targetstringYesA ref or a CSS selector.
valuesarray of at least 1 stringYesThe options to select.
tabstringNoThe tab, such as t1.

check

Checks a checkbox, a radio button or a switch, or unchecks it with checked set to false.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
targetstringYesA ref or a CSS selector.
checkedbooleanNotrue by default.
tabstringNoThe tab, such as t1.

drag

Drags source and drops it on target.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
sourcestringYesThe element to drag: a ref or a CSS selector.
targetstringYesThe element to drop it on: a ref or a CSS selector.
tabstringNoThe tab, such as t1.

scroll

Scrolls the page, or the content of target, such as a list or a panel.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
directionup, down, left, or rightNoThe direction to scroll.
amountnumber, at least 1NoPixels to scroll.
targetstringNoA ref or a CSS selector.
tabstringNoThe tab, such as t1.

wait

Waits for an element state, text, a URL, a load state, a download, or a fixed time. Give one of them. Read-only.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
tabstringNoThe tab, such as t1.
targetstringNoA ref or a CSS selector.
statevisible, hidden, attached, or detachedNoThe state of target to wait for.
textstringNoText to appear on the page.
urlstringNoText that the tab's URL must contain, or a pattern with *. See wait in the Commands reference.
loadload, domcontentloaded, or networkidleNoA load state to reach.
msinteger, 0 to 30000NoA fixed wait, in milliseconds.
downloadbooleanNoWait for a download to finish.
timeoutinteger, 0 to 50000NoMilliseconds before giving up.

get

Reads text, HTML, Markdown, a field's value, an attribute, a count or a bounding box from target, or the title or URL of the tab. Without target, markdown reads the main content of the page. With what set to locator, it lists ways to find target again in a later session, best first, for code that calls Commands. Read-only.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
whattext, html, markdown, value, attr, title, url, count, box, or locatorYesWhat to read.
targetstringNoA ref or a CSS selector. Required for every what except markdown, title and url. count takes a CSS selector, not a ref.
attributestringNoThe attribute to read, with what set to attr.
tabstringNoThe tab, such as t1.

find

Finds elements by role, text, label, placeholder, alt text, title, test ID or CSS selector, and returns their refs. Read-only.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
byrole, text, label, placeholder, alt, title, testid, or cssYesHow to find the elements.
valuestringYesWhat to look for.
namestringNoThe accessible name, with by set to role.
exactbooleanNoMatch the whole text.
tabstringNoThe tab, such as t1.

screenshot

Captures the visible part of the tab, the full page or target, and returns it as a JPEG image.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringNoThe next from the previous result.
targetstringNoA ref or a CSS selector.
full_pagebooleanNoCapture the whole page.
tabstringNoThe tab, such as t1.

eval

Runs a script in the tab and returns its value. Use it to extract data that the other tools do not reach.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
afterstringYesThe next from the previous result.
tabstringYesThe tab, such as t1.
scriptstringYesAn expression or a function body. Its value is returned.
timeoutinteger, 0 to 50000NoMilliseconds before giving up.

tab

Lists the tabs, opens a new one, at url if given, or closes tab.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
actionlist, new, or closeYesWhat to do.
afterstringNoThe next from the previous result. Required to open or close a tab.
tabstringNoThe tab to close.
urlstringNoThe URL to open in the new tab.

status

Waits for an execution that is still running, and returns its result. Read-only.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
executionstringYesThe ID of the running execution, from an earlier result.

cancel

Stops an execution that is still running.

ParameterTypeRequiredDescription
session_idstringYesThe session to act on.
executionstringYesThe ID of the running execution, from an earlier result.

Logs

These tools read a session that is running or that has ended.

session_logs

Returns the newest console messages, page errors and page loads of a session, in time order. Add network to types to see every request and response with its status code. Read-only.

ParameterTypeRequiredDescription
session_idstring, a UUIDYesThe session to read.
typesarray of 1 or more of console, errors, network, navigationNoWhich events to return. console, errors and navigation by default.
sincestring, an ISO 8601 timeNoOnly events at or after this time.
untilstring, an ISO 8601 timeNoOnly events at or before this time.
limitinteger, 1 to 200NoHow many of the newest events to return. 100 by default.

session_traces

Returns the newest clicks, key presses, form fills and page loads of a session, in time order. It includes actions taken outside the MCP server, for example by your own scripts. Each step names its element with a CSS selector, so that a script can repeat it. Typed text is never shown, only its length. Read-only.

ParameterTypeRequiredDescription
session_idstring, a UUIDYesThe session to read.
sincestring, an ISO 8601 timeNoOnly events at or after this time.
untilstring, an ISO 8601 timeNoOnly events at or before this time.
limitinteger, 1 to 200NoHow many of the newest events to return. 100 by default.