run_read_only_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. A job still running carries next, the call that follows it.

{
  "tool_id": "tool_11111111111111111111111111111111",
  "input": "{\"origin\":\"SFO\",\"destination\":\"JFK\",\"departure_date\":\"2026-11-20\"}"
}

{
  "id": "job_55555555555555555555555555555555",
  "type": "run",
  "status": "succeeded",
  "tool_id": "tool_11111111111111111111111111111111",
  "input_request": null,
  "result": {
    "flights": [
      {
        "flight_id": "gf-ua1534-20261120",
        "airline": "United",
        "departs_at": "2026-11-20T07:05:00-08:00",
        "arrives_at": "2026-11-20T15:40:00-05:00",
        "stops": 0,
        "price_usd": 289
      },
      {
        "flight_id": "gf-b6416-20261120",
        "airline": "JetBlue",
        "departs_at": "2026-11-20T10:30:00-08:00",
        "arrives_at": "2026-11-20T19:05:00-05:00",
        "stops": 0,
        "price_usd": 304
      }
    ]
  },
  "result_status": "available",
  "result_expires_at": "2026-10-09T18:00:06.000Z",
  "write_status": "not_attempted",
  "login_save": null,
  "error": null,
  "message": null,
  "maintenance": null,
  "build": null,
  "watch_url": "https://app.pomerado.ai/jobs/job_55555555555555555555555555555555",
  "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

It changes nothing on the website, so several calls can run at once.
Pass the tool’s id from find_website_tool as tool_id. A tool whose effect is write is refused with tool_not_read_only; run it with run_website_tool.
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: Reads only; changes nothing.

Overview

Pomerado MCP

Integration MCP

run_read_only_website_tool

Arguments

Output

​Arguments

​Output

Arguments

Output