Run a website task
run_taskCarry out a website task from a plain-English goal in a real browser: navigate, click, type, fill forms, and read the outcome, returning structured data when a schema is supplied.
Instructions
Carry out a task on a website from a plain-English goal: navigate, click, type, fill in forms and read the outcome, in a real browser. Returns the outcome and, when result_schema is given, the data in that shape. If the task is still going when the call returns, the reply has status "running" and a task_id: call get_task with it. Each call starts a fresh browser session with no saved logins.
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": "run_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | What to accomplish, with every detail needed to finish it, e.g. "Find the cheapest direct flight from Boston to Denver on March 3 and return the airline, times and price". | |
| effort | No | How much capability to spend. Default medium; raise it for hard pages, lower it for simple ones. | |
| secrets | No | Names of private values the task may type (passwords, one-time codes). Each value is read from NODEMANTIS_SECRET_<NAME> in this server's environment; refer to one in the goal as <secret:NAME>. | |
| max_steps | No | Stop after this many steps. Default 30. | |
| start_url | No | Page to open first (http or https). Omit to let the task find its own way. | |
| use_proxy | No | Route the browser through the proxy configured in this server's environment. Default false. | |
| max_cost_usd | No | Stop once the task has spent this many US dollars. | |
| show_browser | No | Show the browser window while the task runs. Default false unless the server was started with --headed. | |
| result_schema | No | JSON Schema describing the shape of the data to return, for example {"type":"object","properties":{"price":{"type":"number"}},"required":["price"]}. Omit it for a free-form answer. | |
| timeout_seconds | No | Stop after this long. Default 300. |