Run a goal autonomously
browser_runAutomates multi-step browser tasks by handing a concrete goal to a decision model that plans, executes, and verifies each action, returning status, trace, cost, and final page text.
Instructions
Hand over a full goal: Jev decides each step, code executes and verifies it, up to max_steps. Returns status, a per-step trace (operation, target, confidence, goal/stuck probabilities), usage.est_cost_usd, and the final page text. Statuses: done | goal_achieved | needs_text | needs_value | stuck | blocked | max_steps | timeout | error. Follow-ups: needs_text/needs_value → fill the reported ref with browser_type/browser_select, then browser_run again with the same goal (page state persists). stuck/blocked → browser_observe/browser_extract and decide yourself. Supply values for any fields the goal needs. Best default for multi-step tasks; use browser_act when you want to review each step.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"goal": "<goal>"
},
"name": "browser_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Open this URL first; otherwise the current page is used. | |
| goal | Yes | What to accomplish, in one or two sentences. Be concrete, e.g. "Find the price of the Pro plan and stop when it is visible." | |
| values | No | Field label → text to type, for any fields the task needs. Contents never go to Jev. | |
| max_chars | No | Cap on returned final page text (default 6000). | |
| max_steps | No | Max Jev decisions (default 20); each costs a fraction of a cent. | |
| max_seconds | No | Wall-clock budget in seconds (default 120). |