Quickstart
Connect an assistant and make a harmless first read.
API 2.3.3 · Published service contract ↗
Set up Sym
Sign in at app.sym.so, install Sym Bridge from sym.so/download and connect the browser or computer you intend to use.
Create a Pass
Create the Browser or Computer Pass in Sym and choose its permissions. The device must be online and connected.
Connect your assistant
Add https://mcp.sym.so/mcp as a remote MCP server. Sign in with Sym and explicitly select the Passes and permissions to delegate.
Read before acting
Ask the assistant to list your authorized Passes, read the chosen Pass documentation and list its tabs. Approve actions separately.
First MCP call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "sym_passes",
"arguments": {}
}
}Your MCP client handles transport initialization and OAuth. tools/list lists tools; sym_passes lists the Passes authorized for this connection.
Working with a Pass
- Setup once: use the existing authenticated connection and selected approved Pass; sym_account is optional diagnostics.
- Call sym_passes only if the approved Pass ID is unknown; tools/list discovers tools, not browsers.
- Read sym_pass_docs once for the selected Pass; retain profile/revision and target IDs. Subsequent actions invoke directly without account/discovery/tabs/window/navigation preflights.
- Use sym_browser_read/sym_computer_read for observation and sym_browser_act/sym_computer_act for actions. Legacy sym_browser/sym_computer remain compatible mixed-operation tools. Use the same Pass/session and a fresh requestId. Browser arguments are validated against that operation’s exact native schema.
- Inspect the result after acting. Never automatically replay an uncertain action. Reconnect OAuth only for authentication errors, not payment_required.