Skip to main content
Glama

Create tab

create_tab

Opens a saved URL. Set queue_audit=false to monitor a discovered origin without a page audit. Past the free tab allowance it answers 402 with accepts[]: pay and repeat.

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": {
      "guest_token": "<guest_token>",
      "url": "<url>"
    },
    "name": "create_tab"
  }
}

Input Schema

NameRequiredDescriptionDefault
urlYesThe URL the tab will follow.
aliasNoLabel to recognise the tab in the list.
guest_tokenYesPrivate owner token returned by guest creation. Sent in X-Guest-Token; reuse it for this owner's resources.
queue_auditNoDefaults to true. Use false to save an idle page for domain monitoring without queuing a page audit. Existing pages keep their current state.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / guest_token / description
      Added value: +"Private owner token returned by guest creation. Sent in X-Guest-Token; reuse it for this owner's resources."
  2. Changed1 schema field changed
    • addedInput schema / properties / queue_audit
      Added value: +{
      +  "default": true,
      +  "description": "Defaults to true. Use false to save an idle page for domain monitoring without queuing a page audit. Existing pages keep their current state.",
      +  "type": "boolean"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / properties / alias / description
      Added value: +"Label to recognise the tab in the list."
    • addedInput schema / properties / url / description
      Added value: +"The URL the tab will follow."
  4. First observed

TDQS

B3.3/5.0
Behavior4/5

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

The annotations cover safety and idempotency (readOnlyHint=false, destructiveHint=false, idempotentHint=false, openWorldHint=true), so the bar is lower, and the description still adds real behavioral context the annotations lack: the free tab allowance, the 402 response shape with accepts[], and the pay-and-repeat remediation. It omits what the call returns and how the new tab relates to later run/watch calls, so it is strong but not exhaustive.

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?

Three short sentences, with the core action and the payment failure mode front-loaded and no filler. The final sentence is telegraphic ("pay and repeat") to the point of being terse, which trims a fraction of clarity.

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

Completeness3/5

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

For a create tool with four parameters, no output schema, and a paywall, the description covers the failure mode well but not what success yields — no indication of a tab identifier or whether a follow-up run_tab is needed. The guest_token requirement and the free-allowance threshold itself are left unstated.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already defines url, alias, guest_token, and queue_audit in detail. The description's queue_audit sentence largely restates the schema's own wording about skipping a page audit, adding no syntax or format detail beyond it. Baseline 3 applies.

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

Purpose3/5

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

"Opens a saved URL" conveys the create action indirectly but never states the resource it creates (a tab) — that noun only exists in the name and title, and "saved URL" is misleading since the caller supplies an arbitrary URL. The queued-audit behavior does hint at what the resulting tab is for, but the tool is not sharply distinguished from run_tab, watch_tab, or list_tabs.

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?

It gives one concrete conditional: use queue_audit=false when monitoring a discovered origin without a page audit. Beyond that there is no guidance on when to call create_tab versus run_tab or watch_tab, nor on prerequisites such as obtaining a guest_token first. Usage is implied rather than routed.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.