Skip to main content
Glama

oassis — web scraping, crawling and browser control for AI agents

by dev.oassis
OverviewDiscussionsAdmin

web_act

Runs actions against an open session and returns the resulting state. Actions: {navigate}, {click:{ref}}, {type:{ref,text,clear}}, {select:{ref,value}}, {press}, {scroll}, {wait}, {back}. The ref is the one controls gave you. It stops at the first failure and tells you where. $0.0005 (0.25 credit) per action, plus requested outputs and any outstanding browser time. API key and credits required. Reference for the oassis API: https://oassis.dev/openapi.json

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pdfNoOptions for the `pdf` format: `format` (a4, letter, legal…), `landscape`, `printBackground`, `scale` 0.1 to 2.
urlNoPage to process.
jsonNoFor the `json` format: a `prompt` describing what to pull out, a JSON `schema` to fill, or both.
waitNoWhen to consider the page loaded: `until` (load, domcontentloaded, networkidle0, networkidle2), `selector` to wait for, `timeout` in ms.
blockNoWhat not to load, which makes a render faster and cheaper. `resourceTypes` takes image, font, stylesheet, media… and `urlPatterns` are regular expressions, not globs: `\.svg$`, not `*.svg`.
linksNoOptions for the `links` format: `visibleOnly`, `excludeExternal` to keep only internal links.
maxAgeNoAccept an answer up to this many milliseconds old. A cache hit costs $0.0002 instead of the format price. Leave it out to force a fresh render.
actionsYesWhat to do, in order: click, type, select, scroll, hover, press, navigate, wait. One to twenty-five per call.
formatsNoOutputs you want in the same response. `controls` is the map of what can be clicked; `elements` needs `selectors`; `json` needs `json.prompt` or `json.schema`.
requestNoHow to make the request: `headers`, `cookies`, `userAgent`, and `auth` for basic authentication.
binaryAsNoHow a screenshot or a PDF comes back. `base64` is the only value today.base64
controlsNoOptions for the `controls` format: `visibleOnly`, and `limit` (1 to 1000) to cut the map.
viewportNoThe window to render in: `width`, `height`, `deviceScaleFactor`.
selectorsNoCSS selectors for the `elements` format.
sessionIdYesThe session to act on, from `web_session_open`.
screenshotNoOptions for the `screenshot` format: `fullPage` for the whole page, `type` (png, jpeg, webp), `quality` 1-100 (not with png), `omitBackground`, `selector` to capture one element, and its own `viewport`.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / binaryAs / enum
      Previous value: -[
-  "base64",
-  "url"
-]New value: +[
+  "base64"
+]
    • removedInput schema / properties / json / properties / model
      Removed value: -{
-  "minLength": 1,
-  "type": "string"
-}
  2. Changed37 schema fields changed
    • changedInput schema / properties / actions / description
      Previous value: -"Actions, in order."New value: +"What to do, in order: click, type, select, scroll, hover, press, navigate, wait. One to twenty-five per call."
    • addedInput schema / properties / actions / items / anyOf
      Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "navigate": {
+        "format": "uri",
+        "type": "string"
+      }
+    },
+    "required": [
+      "navigate"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "click": {
+        "additionalProperties": false,
+        "properties": {
+          "ref": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "selector": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "click"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "type": {
+        "additionalProperties": false,
+        "properties": {
+          "clear": {
+            "type": "boolean"
+          },
+          "ref": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "selector": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "text"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "type"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "select": {
+        "additionalProperties": false,
+        "properties": {
+          "ref": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "selector": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "value"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "select"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "press": {
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "press"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "scroll": {
+        "additionalProperties": false,
+        "properties": {
+          "by": {
+            "type": "number"
+          },
+          "to": {
+            "enum": [
+              "top",
+              "bottom"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "scroll"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "wait": {
+        "additionalProperties": false,
+        "properties": {
+          "ms": {
+            "maximum": 30000,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "selector": {
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "wait"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "back": {
+        "const": true,
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "back"
+    ],
+    "type": "object"
+  }
+]
    • removedInput schema / properties / actions / items / type
      Removed value: -"object"
    • addedInput schema / properties / actions / maxItems
      Added value: +25
    • addedInput schema / properties / actions / minItems
      Added value: +1
    • addedInput schema / properties / binaryAs
      Added value: +{
+  "default": "base64",
+  "description": "How a screenshot or a PDF comes back. `base64` is the only value today.",
+  "enum": [
+    "base64",
+    "url"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / block
      Added value: +{
+  "additionalProperties": false,
+  "description": "What not to load, which makes a render faster and cheaper. `resourceTypes` takes image, font, stylesheet, media… and `urlPatterns` are regular expressions, not globs: `\\.svg$`, not `*.svg`.",
+  "properties": {
+    "resourceTypes": {
+      "items": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "urlPatterns": {
+      "items": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / controls
      Added value: +{
+  "additionalProperties": false,
+  "description": "Options for the `controls` format: `visibleOnly`, and `limit` (1 to 1000) to cut the map.",
+  "properties": {
+    "limit": {
+      "maximum": 1000,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "visibleOnly": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / formats / default
      Added value: +[
+  "controls"
+]
    • changedInput schema / properties / formats / description
      Previous value: -"Outputs you want in the same response. `controls` is the map of what can be clicked; `elements` needs `selectors`; `json` needs `json.prompt`."New value: +"Outputs you want in the same response. `controls` is the map of what can be clicked; `elements` needs `selectors`; `json` needs `json.prompt` or `json.schema`."
    • addedInput schema / properties / formats / maxItems
      Added value: +9
    • addedInput schema / properties / formats / minItems
      Added value: +1
    • addedInput schema / properties / json / additionalProperties
      Added value: +false
    • changedInput schema / properties / json / description
      Previous value: -"For the `json` format: `prompt` and/or `schema`."New value: +"For the `json` format: a `prompt` describing what to pull out, a JSON `schema` to fill, or both."
    • addedInput schema / properties / json / properties / model
      Added value: +{
+  "minLength": 1,
+  "type": "string"
+}
    • addedInput schema / properties / json / properties / prompt / minLength
      Added value: +1
    • addedInput schema / properties / json / properties / schema / additionalProperties
      Added value: +{}
    • addedInput schema / properties / links
      Added value: +{
+  "additionalProperties": false,
+  "description": "Options for the `links` format: `visibleOnly`, `excludeExternal` to keep only internal links.",
+  "properties": {
+    "excludeExternal": {
+      "type": "boolean"
+    },
+    "visibleOnly": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / maxAge / maximum
      Added value: +604800000
    • addedInput schema / properties / maxAge / minimum
      Added value: +0
    • changedInput schema / properties / maxAge / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / pdf
      Added value: +{
+  "additionalProperties": false,
+  "description": "Options for the `pdf` format: `format` (a4, letter, legal…), `landscape`, `printBackground`, `scale` 0.1 to 2.",
+  "properties": {
+    "format": {
+      "enum": [
+        "letter",
+        "legal",
+        "tabloid",
+        "ledger",
+        "a0",
+        "a1",
+        "a2",
+        "a3",
+        "a4",
+        "a5",
+        "a6"
+      ],
+      "type": "string"
+    },
+    "landscape": {
+      "type": "boolean"
+    },
+    "printBackground": {
+      "type": "boolean"
+    },
+    "scale": {
+      "maximum": 2,
+      "minimum": 0.1,
+      "type": "number"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / request
      Added value: +{
+  "additionalProperties": false,
+  "description": "How to make the request: `headers`, `cookies`, `userAgent`, and `auth` for basic authentication.",
+  "properties": {
+    "auth": {
+      "additionalProperties": false,
+      "properties": {
+        "password": {
+          "type": "string"
+        },
+        "username": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "username",
+        "password"
+      ],
+      "type": "object"
+    },
+    "cookies": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "domain": {
+            "type": "string"
+          },
+          "httpOnly": {
+            "type": "boolean"
+          },
+          "name": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "secure": {
+            "type": "boolean"
+          },
+          "value": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "value"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "headers": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "type": "object"
+    },
+    "userAgent": {
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / screenshot
      Added value: +{
+  "additionalProperties": false,
+  "description": "Options for the `screenshot` format: `fullPage` for the whole page, `type` (png, jpeg, webp), `quality` 1-100 (not with png), `omitBackground`, `selector` to capture one element, and its own `viewport`.",
+  "properties": {
+    "fullPage": {
+      "type": "boolean"
+    },
+    "omitBackground": {
+      "type": "boolean"
+    },
+    "quality": {
+      "maximum": 100,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "selector": {
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": {
+      "enum": [
+        "png",
+        "jpeg",
+        "webp"
+      ],
+      "type": "string"
+    },
+    "viewport": {
+      "additionalProperties": false,
+      "properties": {
+        "deviceScaleFactor": {
+          "maximum": 3,
+          "minimum": 0.1,
+          "type": "number"
+        },
+        "height": {
+          "maximum": 4096,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "width": {
+          "maximum": 4096,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "width",
+        "height"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}
    • changedInput schema / properties / selectors / description
      Previous value: -"CSS selectors for `elements`."New value: +"CSS selectors for the `elements` format."
    • addedInput schema / properties / selectors / items / minLength
      Added value: +1
    • addedInput schema / properties / selectors / minItems
      Added value: +1
    • changedInput schema / properties / sessionId / description
      Previous value: -"The one web_session_open returned."New value: +"The session to act on, from `web_session_open`."
    • addedInput schema / properties / sessionId / minLength
      Added value: +1
    • addedInput schema / properties / url / format
      Added value: +"uri"
    • addedInput schema / properties / viewport
      Added value: +{
+  "additionalProperties": false,
+  "description": "The window to render in: `width`, `height`, `deviceScaleFactor`.",
+  "properties": {
+    "deviceScaleFactor": {
+      "maximum": 3,
+      "minimum": 0.1,
+      "type": "number"
+    },
+    "height": {
+      "maximum": 4096,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "width": {
+      "maximum": 4096,
+      "minimum": 1,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "width",
+    "height"
+  ],
+  "type": "object"
+}
    • addedInput schema / properties / wait / additionalProperties
      Added value: +false
    • changedInput schema / properties / wait / description
      Previous value: -"When to consider the page loaded: `until`, `selector`, `timeout`."New value: +"When to consider the page loaded: `until` (load, domcontentloaded, networkidle0, networkidle2), `selector` to wait for, `timeout` in ms."
    • addedInput schema / properties / wait / properties / selector / minLength
      Added value: +1
    • addedInput schema / properties / wait / properties / timeout / maximum
      Added value: +60000
    • addedInput schema / properties / wait / properties / timeout / minimum
      Added value: +100
    • changedInput schema / properties / wait / properties / timeout / type
      Previous value: -"number"New value: +"integer"
  3. First observed

TDQS

A4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations (readOnlyHint false, openWorldHint true, idempotentHint false, destructiveHint false) by disclosing failure semantics ('stops at the first failure and tells you where'), per-action pricing ($0.0005 plus outputs and browser time), and auth/billing prerequisites (API key and credits required). These are exactly the operational facts an agent needs before committing to a paid, non-idempotent call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads purpose, then action grammar, then failure behavior, then cost/auth. Every sentence carries weight, though the trailing API-reference URL and credit note read slightly like boilerplate appended to the end.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-parameter tool with no output schema, the description covers actions, ref provenance, failure behavior, cost, and auth. The one gap is the return value: 'returns the resulting state' is vague where there is no output schema to fall back on, so the agent cannot tell what shape 'state' takes.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning beyond the schema by explaining that `ref` is the identifier handed out by the `controls` format — a cross-tool coupling the schema never states. It also enumerates the action shapes verbatim (though the schema's `actions` list mentions 'hover', which the description omits).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — 'Runs actions against an open session' — and enumerates the exact action types (navigate, click, type, select, press, scroll, wait, back). It implicitly distinguishes itself from web_session_open by scoping to an already-open session, but it never names a sibling tool to contrast against, so it stops just short of full differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: the agent learns refs must come from `controls` and that this operates on an open session, which signals the workflow. However, there is no explicit when-to-use/when-not guidance and no comparison to alternatives like web_task_start or web_scrape for similar page work.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All oassis — web scraping, crawling and browser control for AI agents toolsInspect
Try in Browser
Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources