run_website_tool

Arguments

Argument	Required	Type	Description
`tool_id`	Yes	string	The ID of the tool to run, from a tool search
`login_id`	No	string	The saved login to sign in with, when the site has several
`login`	No	object	A login for this call, used only when the site has no saved login: a username (or email, phone or account number) and password, or mode “code” without a password when the site sends a code. It passes through your client and model provider; without it, the run asks the person on its answer page.
`save_login`	No	boolean	Save login for later runs (requires login)
`two_factor_method`	No	one of: `sms`, `call`, `email`, `authenticator`, `push`	The two-factor method to use when the site offers several; one the tool supports
`correct_login`	No	one of: `true`	Fix the rejected saved login named by login_id during this run
`idempotency_key`	No	string	Your key for this call. Reuse it only to retry the same call, which then returns the same job instead of acting on the website again.
`input`	Yes	string	The tool’s input, JSON-encoded, as its input_schema describes.

Output

The run’s job, with the tool’s result in result once it succeeds and write_status saying whether the website changed. A job still running carries next, the call that follows it.

{
  "tool_id": "tool_33333333333333333333333333333333",
  "input": "{\"items\":[{\"name\":\"Bananas\",\"quantity\":6}]}",
  "idempotency_key": "cart-2026-10-09-bananas"
}

{
  "id": "job_66666666666666666666666666666666",
  "type": "run",
  "status": "succeeded",
  "tool_id": "tool_33333333333333333333333333333333",
  "input_request": null,
  "result": { "cart_item_count": 1, "cart_subtotal_usd": 1.74 },
  "result_status": "available",
  "result_expires_at": "2026-10-09T18:00:06.000Z",
  "write_status": "applied",
  "login_save": null,
  "error": null,
  "message": null,
  "maintenance": null,
  "build": null,
  "watch_url": "https://app.pomerado.ai/jobs/job_66666666666666666666666666666666",
  "created_at": "2026-10-09T17:00:00.000Z",
  "updated_at": "2026-10-09T17:00:06.000Z",
  "completed_at": "2026-10-09T17:00:06.000Z"
}

Details

Pass the tool’s id from find_website_tool as tool_id.
It runs any tool. For a tool whose effect is read, use run_read_only_website_tool instead; several of those can run at once.
Send an idempotency_key with every write, and reuse it only to retry the same call. A call without one is a new website action.
It waits up to 50 seconds (5 minutes when your client accepts SSE). If the job asks a question or is still running, follow it with get_job instead of calling again.
A tool that signs in uses the site’s saved login; login_id picks one when there are several. With none saved, the job asks the user on its answer page.
When a job needs a login, a code or an approval, give the user its answer_url. Never ask for a password in chat.
Status needs_input with error credentials_rejected means the website rejected the saved login. The job waits up to 60 minutes for the user to correct it on the page its next names, then resumes. Don’t resubmit it.

Effect: May change a website or your account, and a change may not be undoable.

Overview

Pomerado MCP

Integration MCP

Arguments

Output

​Arguments

​Output

Arguments

Output