A
licenseNot graded
qualityC
maintenanceEnables cloud agents to securely operate local machine resources (files, commands, screenshots) via standard MCP protocol.
MIT
ReMCP
by getremcp
ReMCP lets an AI client read, write, and manage files, run shells, control the desktop, capture images, inspect the system, and edit documents on a paired computer over an outbound-only MCP connection.
Read files (
read_file): read text/line-oriented files with offset/length paging, including negative offsets from the end.Manage files (
manage_files): search and glob files, read/write binaries in base64 chunks, hash files, list directories, get file info, write/edit/bulk-write, apply unified diffs, chmod/chown, block edits, line replacement, project-wide regex replace, diff files, move/copy/delete/trash paths, create/extract tar/tar.gz/zip archives, and manage search sessions.Run terminal (
run_terminal): start shell commands, read/wait/interact with output, force-terminate, and list sessions.Control computer (
control_computer): take accessibility/DOM/OCR snapshots, click/invoke/focus/set values/select/toggle/scroll on UI elements, multi-select/multi-edit, launch apps, and open or reveal paths.View images (
view_image): read existing image files and take desktop/window/monitor/region screenshots.Manage system (
manage_system): get system/runtime info and stats, list/kill processes, set runtime limits and telemetry, run network diagnostics, list installed apps, and inspect environment.Manage documents (
manage_documents): read PDF/DOCX/XLSX, edit spreadsheets and DOCX files, and merge/split/extract/inspect PDFs.
All operations execute with the permissions of the account running the agent (SSH-like trust model), with no per-call approval prompt.
Offers a plugin for GitHub Copilot, allowing it to use ReMCP to interact with a paired computer's filesystem, processes, and system via the local runtime.
Provides a plugin for ChatGPT and Codex, enabling them to use ReMCP's runtime to manage files, run processes, capture screenshots, and control a paired computer.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ReMCPList the log files in my home directory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ReMCP connects a computer you own or administer to ChatGPT & Codex, Cursor, Claude Code, Gemini CLI, Kiro, Cline, or another MCP client. The device agent makes an outbound connection only — no inbound port, no tunnel, no third-party desktop relay. This repository contains the public device client/runtime, portable Agent Plugin metadata, the Gemini CLI extension manifest, official MCP Registry metadata, and the host-specific OpenAI and Anthropic plugin packaging.
Packages
Package | What it is |
The device client: pairing, the outbound agent, the background service, and the usage-metrics switch. | |
The first-party local runtime: 83 MCP tools for files, images, binary transfer, archives, screenshots, search, terminal/process work, native desktop UI, loopback browser CDP, diagnostics, lightweight documents, and narrowly scoped runtime preferences, with two direct dependencies. |
Related MCP server: HostGate MCP
Install
Open ReMCP → Connect a machine. The page detects the computer's operating system and shows the correct one-command flow.
Windows PowerShell — no preinstalled Node.js, npm, npx, or winget required:
irm https://remcp.site/i | iexReMCP keeps its Windows runtime privately under %LOCALAPPDATA%\ReMCP; it does not install Node.js
globally or add the private runtime directory to the system PATH.
macOS / Linux: Node.js 22.5 or newer provides the current npm/npx distribution path.
npx --yes @remcp/remcp@latest connectThe browser can also generate a one-time pairing command. Run that exact command on the computer you want to connect; it installs the runtime and registers the background service.
Pairing codes are generated in the authenticated workspace, expire automatically, and are single-use. Do not invent or reuse a code from documentation.
Commands
Command | Purpose |
| Start the device agent when no managed background service is already running |
| Show device, client/runtime versions, managed-agent state, update consistency and server reachability as JSON |
| Status plus a real local-runtime handshake and filesystem diagnostics |
| Install or repair the persistent user service |
| Update the client and runtime, then restart the service |
| Stop and remove the user service |
| Remove the service and the global packages |
| Show or change usage metrics for the client and the runtime |
| Show or change this computer's local unrestricted mode |
| Print the installed client version |
Plugins
For users, ReMCP is catalog-first:
Install from your AI host → sign in to ReMCP → use your paired computers.
You do not need to paste an MCP server URL, edit a manifest, clone this repository, or configure a local path just to use the published plugin.
Shareable install guides:
ChatGPT & Codex: https://remcp.site/install/chatgpt
Claude Code: https://remcp.site/install/claude
ChatGPT & Codex / OpenAI
ChatGPT and Codex share OpenAI's public plugin directory.
Search for ReMCP and open the ReMCP plugin card when it is available.
Choose Install plugin.
If prompted, choose Connect and complete ReMCP OAuth.
In ChatGPT, use @ReMCP when you want to invoke it explicitly. In Codex, use Sources → Use plugins → ReMCP.
If ReMCP is not visible yet, the listing or rollout is not available to that account. There is no manual MCP endpoint an ordinary plugin user needs to configure while waiting.
Claude Code / Anthropic
ReMCP was submitted through Claude Platform on September 18, 2026 and currently shows Submitted and pending review.
After approval:
Open https://claude.com/plugins. In Claude or Claude Desktop, you can also use Customize → Plugins → + → Browse plugins.
Search for ReMCP and confirm it supports Claude Code.
Choose Install.
Complete ReMCP authorization if Claude asks you to connect.
Ask Claude Code to use ReMCP on a computer already paired to your account.
While the listing is under review, ordinary users do not need to add a marketplace, clone this repository, or paste an MCP endpoint. Developer and reviewer workflows live in the technical guide.
Start with Plugin overview →.
Cursor and the wider MCP ecosystem
ReMCP publishes host-native metadata for coding agents plus directory records for MCP discovery:
Host / directory | User path | Status |
Cursor | Find ReMCP in Cursor Marketplace and install it. | published |
Gemini CLI | Install from the Extension Gallery when indexed, or run | gallery discovery enabled |
GitHub Copilot CLI | Install from the | submitted |
VS Code Agent Plugins | Browse | submitted |
Kiro Powers | Import | submitted |
Cline | Use the Cline MCP Marketplace after review; the current submission is tracked in | submitted |
Smithery | published | |
Glama | Open the ownership-verified connector at https://glama.ai/mcp/connectors/site.remcp/re-mcp. | verified / healthy |
Awesome Remote MCP Servers | Open the community directory; ReMCP is listed under Developer Tools after PR #435 was merged. | listed |
Official MCP Registry | Search for | published |
The same ReMCP OAuth account and paired computers sit behind every route. Marketplace and directory surfaces change discovery; they do not create separate ReMCP backends.
Distribution manifests, direct install commands, and review links are documented in PLUGINS.md → and DISTRIBUTION.md →.
Developer / reviewer internals
Host-specific manifests, MCP configuration, validation commands, submission artifacts, and local development workflows remain documented separately:
The OpenAI files and Claude files deliberately do not overwrite each other. Release checks fail if either host-specific contract drifts from the shared ReMCP version or production endpoint.
The local runtime
@remcp/runtime is a clean-room MCP server written for ReMCP. It is not a fork of, and shares no code
with, DesktopCommanderMCP or any other MCP
server.
83 granular device operations, 10 hosted production definitions. Current production advertises 8 device-facing façade tools plus 2 account/fleet tools, all model-visible. If custom widgets are explicitly re-enabled, discovery expands to 15 definitions by adding 5 app-only UI helpers. See the generated full tool reference for every current façade and its operation list.
Device runtime surface:
Area | Tools |
Read |
|
Write / edit |
|
Organise |
|
Delete |
|
Transfer |
|
Screen |
|
Search |
|
Processes |
|
Runtime |
|
Computer use |
|
Browser |
|
Diagnostics |
|
Documents |
|
The hosted ReMCP endpoint currently advertises 10 model-visible tools with REMCP_CUSTOM_WIDGETS_ENABLED=false; no app-only render/save/refresh helpers or structuredContent.preview references are exposed. The compact surface routes to all 83 granular runtime operations, and 100 compatibility names remain callable for cached clients without inflating discovery for new models. If widgets are explicitly re-enabled later, the hosted catalog expands to 15 definitions and 105 compatibility names. Each online device returned by list_devices reports its live supported subset, and unavailable operations fail closed.
Tool selection for AI agents
ReMCP publishes selection-oriented descriptions and ships the same decision tree in its operator skill:
native Accessibility/UI Automation → browser DOM/CDP → OCR → coordinates
Start unfamiliar desktop work with
computer_snapshot; useui_snapshot/ui_find/ui_actionfor native apps.For Chromium page content use
browser_navigate action=new_tabwhen needed, thenbrowser_snapshot/browser_find/browser_action/browser_waitinstead of desktop coordinates.Use
type_textfor normal Unicode text in native/focused controls,browser_actionfor Chromium page DOM text, andkeyboardfor shortcuts/navigation keys.Use
pointeronly when semantic actions cannot express the task; prefer element ids fordrag_drop. GNOME Wayland drag uses the consent-backed Remote Desktop portal rather than unreliable XTEST drag.Use
wait_for_ui/browser_waitinstead of fixed sleeps.Use
screenshot_regionfor targeted visual proof andrecord_screenonly for motion/timing.Use structured document tools instead of automating Office when the request is about file content.
All 39 computer/browser/diagnostic/document tools declare closed top-level input schemas, parameter descriptions, structured output schemas, and MCP read-only/destructive/idempotent/open-world hints.
Why the tool list looks different from other computer-control servers. Security-sensitive configuration remains deliberately narrow, and everything else the alternatives can do has an equivalent here — usually more than one:
Not included | Why |
Bundled browser/document rendering stacks | ReMCP supports lightweight DOCX/XLSX/PDF operations but deliberately uses OOXML and existing system PDF utilities instead of bundling Puppeteer, |
Broad configuration mutation |
|
URL fetching in | It is a server-side request forgery surface. The runtime reads your computer, not the internet. |
What ReMCP adds beyond the usual set: image reads and screenshots that any MCP client can
display, binary transfer in both directions, archive create/extract, wait_for_process_output instead
of polling, line-range replacement, project-wide replace, unified diffs, checksums, trash instead of
deletion, and host resource reporting.
Nothing is gated. There is no approval prompt, no "are you sure", and no mandatory dry run: a tool
call executes with the full rights of the account running the agent — the same trust model as SSH.
Writes replace by default and moves/copies replace the destination. The catastrophic-command
guardrail defaults to block (a matching command is refused before it runs); an operator may choose
warn or allow.
Files are never written to a local history log, so tool arguments and output are not recorded there.
Unrestricted by design
No per-call approval contour. ReMCP does not add a confirmation dialog before each tool call. The local runtime's configured roots, command blocklist and command policy still apply, as do the operating-system permissions of the account running the agent. Within those boundaries,
start_processcan operate services, packages, databases, containers,sudo, git, and other local tools.Full transfer in both directions.
read_binary/write_binarymove any file,create_archiveandextract_archivemove whole trees, andtake_screenshotshows the desktop.Optional hardening, explicit security boundaries.
remcp godmode onlifts the roots, the blocklist and the command guardrail for one computer — and only a person at that computer can turn it on; no MCP tool accepts it.allowedRootsandblockedCommandsare empty until an operator configures them.dangerousCommandsdefaults toblock: a matching catastrophic command is refused before it runs;warnlets it run with an advisory note andallowsilences even that. The runtime refuses to start — loudly — ifruntime.jsoncannot be parsed, so configured safety boundaries are never silently dropped.Crash-resistant. A bad shell, a closed stdin, or a 40 MB line cannot take the runtime down; the agent restarts it if it exits, so a device recovers instead of going quietly offline.
Outbound-only. Per-device revocable credential, hashed server-side, stored locally with restrictive permissions. Runtime metadata from a custom server requires an explicit
--trust-runtimedecision.No local history. Tool arguments and outputs are never written to a log on your computer.
Usage metrics
Both the client and the runtime collect opt-out usage metrics: tool names, durations, outcomes, coarse error classes, session counts, and device health samples. They never include file paths, file contents, command strings, tool arguments, or tool output — the event schema is a whitelist, so those fields have nowhere to travel.
There is no telemetry endpoint and no third-party processor. The runtime emits MCP notifications to the agent, and the agent forwards them over the authenticated WebSocket it already holds to your ReMCP account. No install ping, no postinstall script, no remote feature flags, no A/B assignment.
remcp telemetry off # one switch for the client and the runtime
remcp telemetry statusDevelopment
npm install
npm run check
npm testBoth workspaces are plain ESM with no build step. The contract commands (--help, --version,
--print-tools, --describe) work with no dependencies installed, so CI can diff the advertised
tool surface against the published tarball.
License
MIT.
Available Tools
7 toolscontrol_computerControl computerADestructiveInspect
Use this for semantic inspection or control of native desktop applications on this computer: windows, accessibility/UI elements, waits, displays, app launch, text/input, clipboard, open/reveal, notifications, or short screen recording. Snapshot/find/wait operations observe state; clicks, typing, window close, app launch, clipboard writes, and recording can change local application state. Prefer semantic targets before raw coordinates.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Concrete local runtime operation to execute in this domain. | |
| parameters | No | Arguments for the selected operation; validated against that operation’s original closed schema. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
A3.8/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already flag destructiveHint=true and openWorldHint=true, but the description goes further by naming precisely which operations alter local application state (clicks, typing, window close, app launch, clipboard writes, recording) versus which merely observe. That operation-level granularity is real added value beyond the blanket annotation hints, though it omits platform/permission caveats like the Wayland portal consent that the schema mentions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three tight sentences: scope enumeration, then the observe/mutate distinction, then the targeting tactic. Nothing is repeated from the title or schema, and the most decision-relevant content (what the tool covers) is front-loaded.
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?
Given the very large nested schema, full annotations, and an existing output schema, the description only needs to convey scope and risk profile, which it does. It falls slightly short on tool-selection context against the six siblings and on platform constraints, but no essential calling information is missing.
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% and only two top-level parameters exist, so the schema carries full burden. The description's 'prefer semantic targets before raw coordinates' adds a targeting strategy that the schema does not state, but otherwise adds no parameter detail — baseline 3 applies.
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?
The description names a specific verb (inspection/control) plus the resource (native desktop applications) and enumerates the covered domains — windows, UI elements, input, clipboard, notifications, recording. It clearly separates this from file/document tools, though it never names a sibling tool to disambiguate edge cases like run_terminal or view_image.
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 provides an internal tactic ('Prefer semantic targets before raw coordinates') and splits operations into observe vs mutate, which implies when each is appropriate. However, it gives no guidance on when to pick this tool over siblings such as run_terminal, manage_system, or view_image, which is the gap the guideline dimension targets.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
manage_documentsManage documentsADestructiveInspect
Use this for structured document content: read PDF/DOCX/XLSX, edit DOCX/XLSX directly, or merge, split, extract, or inspect PDFs. DOCX/XLSX edits can replace the input when no separate output is supplied, and PDF write operations create or replace their requested output; read_document itself is read-only. Use read_file for plain line-oriented text.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Concrete local runtime operation to execute in this domain. | |
| parameters | No | Arguments for the selected operation; validated against that operation’s original closed schema. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
A4.9/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the annotations (destructiveHint=true, readOnlyHint=false), the description discloses the exact destructive behavior: DOCX/XLSX edits can replace the input, and PDF write operations create or replace their requested output. It also reassures that read_document itself is read-only. This meaningfully adds safety context that annotations alone do not provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences with no filler. It front-loads the primary use case, packs key behavioral caveats into the second sentence, and closes with a useful sibling pointer. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has a complex conditional schema with two operations and nested objects, but the description covers the operation families, format support, destructive behavior, and the key alternative. An output schema exists, so return-value details need not be in the description. Nothing an agent needs to correctly invoke the tool is missing.
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 description coverage is 100%, so the baseline is 3. The description adds value beyond the schema by explaining the semantics of the output-related parameters: when output is omitted, edits may modify the input, and PDF write operations overwrite the requested output. This enriches understanding of the 'output' and 'path' parameters without needing to restate the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific scope ('structured document content') and enumerates concrete verbs and resources: read PDF/DOCX/XLSX, edit DOCX/XLSX, and merge/split/extract/inspect PDFs. It also distinguishes itself from the sibling read_file by naming read_file for plain line-oriented text, so an agent can select the correct tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use this tool ('Use this for structured document content') and names the alternative with its condition ('Use read_file for plain line-oriented text'). It further guides usage by clarifying when edits can replace the input versus when a separate output is supplied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
manage_filesManage filesADestructiveInspect
Use this when the task is about files, directories, archives, or filesystem search on this computer. Choose exactly one operation; parameters must contain only that operation’s arguments and are validated against its closed schema. Write, edit, move, permission, and delete operations can change or remove local data, while read and search operations leave files unchanged. Use read_file for one known text file.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Concrete local runtime operation to execute in this domain. | |
| parameters | No | Arguments for the selected operation; validated against that operation’s original closed schema. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| text | Yes | Human-readable result of the tool call. |
TDQS
A4.5/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the annotations' destructiveHint=true, the description names which operation classes can change or remove local data and which leave files unchanged. It also discloses that parameters are validated against a closed per-operation schema. This materially improves the agent's understanding of a large, destructive-capable tool and does not contradict the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, no filler. The use condition is front-loaded, the per-operation constraint is stated clearly, and the read/write safety split and sibling routing are compressed into the remaining sentences. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite managing 29 sub-operations, the description gives the essential orientation: domain scope, one-operation rule, destructive vs read-only behavior, and a fallback to read_file. With such a rich input schema and an output schema present, the individual operation details are already covered structurally, so nothing critical is missing.
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 baseline is 3. The description mostly restates what the schema already says ('parameters must contain only that operation's arguments and are validated against its closed schema'), adding no new meaning to individual parameters. The rich schema carries the parameter semantics.
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?
The description clearly states the tool's scope: files, directories, archives, and filesystem search on this computer. It also distinguishes itself from the sibling read_file by routing single known text files there. The verb is somewhat generic ('manage'), but combined with the title and operation list it is clear enough.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use the tool ('task is about files, directories, archives, or filesystem search'), gives an explicit alternative ('Use read_file for one known text file'), and also separates read/search operations from write/edit/delete operations. An agent can reliably decide between this tool and the read_file sibling without opening the schema.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
manage_systemManage systemADestructiveIdempotentInspect
Use this for operating-system or ReMCP runtime state: system/runtime/process facts, runtime preferences, services, event logs, networking, installed apps, environment, audio, or explicit power actions. Fact, log, and inventory operations only observe state; process termination, preference/service/audio changes, restart, and shutdown can interrupt work or change the machine. Use run_terminal for general shell commands.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Concrete local runtime operation to execute in this domain. | |
| parameters | No | Arguments for the selected operation; validated against that operation’s original closed schema. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
A4.1/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructive, open-world, idempotent, and non-read-only behavior. The description adds useful context by saying which operation classes only observe state and which can interrupt work or change the machine, going beyond the blanket destructive flag. It does not discuss auth, rate limits, or return behavior, but annotations cover the core safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences are front-loaded with scope, safety classification, and sibling routing. There is no redundant restatement of schema details, and every sentence carries selection or safety-relevant information.
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 complex multi-operation tool with annotations and an output schema, the description gives useful domain and safety context. However, it advertises services, event logs, audio, and explicit power actions that the operation enum does not support, leaving an agent with an inaccurate capability map. This gap prevents a higher completeness score.
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 documents operation-specific parameters, enums, and nested requirements. The description does not add argument-level meaning, and several domains it names are not available as operation enum values, which risks confusing operation selection. Baseline 3 is appropriate when the schema does the heavy lifting.
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?
The description states a broad, specific domain—operating-system or ReMCP runtime state—and enumerates categories such as process facts, runtime preferences, networking, installed apps, and environment. It also distinguishes the tool from run_terminal. However, several advertised categories (services, event logs, audio, power actions) are not present in the operation enum, so the scope is not fully precise.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says when to use this tool and directs general shell commands to run_terminal. It also distinguishes observational operations from mutating ones and warns that termination, preference/service/audio changes, restart, and shutdown can interrupt work or change the machine.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
read_fileRead fileARead-onlyIdempotentInspect
Read a plain text or line-oriented file on this computer: source, config, Markdown, scripts or logs. Use read_document for PDF, DOCX, XLSX and other structured documents. Legacy .docx/.pdf extraction remains supported for compatibility. Use offset and length to page through large text files; a negative offset reads from the end.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path of the file to read. Relative paths resolve against the runtime working directory. | |
| length | No | Maximum number of lines to return. | |
| offset | No | Zero-based first line to read. Negative values read the last N lines. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| text | Yes | Human-readable result of the tool call. |
TDQS
A4.7/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already disclose read-only and idempotent behavior)Skip the description. The description adds real behavioral context: it limits the tool to text-like files, explains paging semantics, and discloses the legacy docx/pdf extraction behavior. This goes beyond annotation coverage without redundancy.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, each with a distinct purpose: scope definition, alternative routing, and paging guidance. No fluff or repetition of schema fields. The phrasing is compact and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-file read tool, the description covers scope, exclusions, paging, and compatibility, while the output schema and read-only annotations cover the rest. An agent has enough information to invoke it correctly and to decide when another tool is better.
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. The description adds value beyond the schema by explaining how offset and length should be used together to page through large files and clarifying the negative-offset behavior. This is meaningful, though the schema already documents each parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific action (read), a specific resource type (plain text or line-oriented file), and concrete examples (source, config, Markdown, scripts, logs). Explicitly distinguishes from read_document for PDF/DOCX/XLSX, so an agent can select it among several sibling read tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides explicit routing guidance: use read_document for structured documentsainer and notes legacy .docx/.pdf support for compatibility. Also gives concrete usage advice for large files with offset/length paging and negative offsets.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
run_terminalRun terminal operationsADestructiveInspect
Use this when the task needs a shell command or an existing ReMCP terminal session: start, read, wait, interact, stop, or list sessions. Choose exactly one operation; parameters are validated against that operation’s closed schema. Starting or interacting with commands can change local or external state, and force termination can lose unsaved process work; reading, waiting, and listing do not mutate the session.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Concrete local runtime operation to execute in this domain. | |
| parameters | No | Arguments for the selected operation; validated against that operation’s original closed schema. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
A4.5/5.0
Behavior5/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the annotations, the description explicitly warns that starting or interacting with commands can change local or external state and that force termination can lose unsaved process work, while reading, waiting, and listing do not mutate the session. This clarifies the destructive/non-destructive split across operations and matches the annotation profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three sentences, front-loaded with the trigger condition and operation list, followed by the crucial safety caveats. Every sentence contributes selection guidance or behavioral warning with no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers when to use the tool, the need to select exactly one operation, validation behavior, and the mutation profile of each operation family. Since an output schema exists and the input schema fully documents each operation's parameters, no critical selection or invocation information is missing.
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%, and the input schema already provides detailed descriptions for operation-specific parameters such as pid, offset, pattern, and timeout_ms. The description only adds a structural note about per-operation validation, not new meaning for individual parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific trigger condition ('when the task needs a shell command or an existing ReMCP terminal session') and enumerates the operation families: start, read, wait, interact, stop, and list sessions. This clearly distinguishes the terminal domain from sibling tools like manage_files or control_computer.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives explicit context for when to use the tool and emphasizes that exactly one operation must be chosen, with parameters validated against that operation's schema. It does not explicitly name sibling alternatives or state when not to use the tool, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
view_imageView image or screenshotAInspect
Use this when the result must be pixels from this computer: read an existing image or capture the desktop, one window, monitor, or region. These operations return pixels without interacting with the visible UI. Use control_computer when semantic structure or an action is enough.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | Concrete local runtime operation to execute in this domain. | |
| parameters | No | Arguments for the selected operation; validated against that operation’s original closed schema. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| text | Yes | Human-readable result of the tool call. |
TDQS
A4/5.0
Behavior3/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses a key behavioral trait: 'These operations return pixels without interacting with the visible UI', which is useful beyond the annotations. However, it claims capture of 'one window, monitor, or region' while the input schema for take_screenshot only exposes keep and directory parameters, leaving a behavioral promise the schema does not support. Annotations are all false and provide no additional coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the key selection criterion ('when the result must be pixels'), and zero filler. The alternative and exclusion are stated efficiently in the second sentence.
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?
The discriminated-union schema and output schema provide good structural coverage, and the description supplies overall context. However, the description overpromises window/monitor/region capture that is not reflected in the schema, creating a serious mismatch an agent must resolve before calling the tool correctly. This gap makes the definition not fully complete for its complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters2/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline should be 3cars, but the description actively adds misleading meaning by mentioning 'one window, monitor, or region' capture when no schema parameter supports selecting those targets. It does not clarify how the operation discriminates between read_image and take_screenshot beyond the fixed operation enum, and the unsupported target claims could cause an agent to pass invalid parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific purpose: 'Use this when the result must be pixels from this computer', and enumerates the exact operations (read an existing image or capture desktop/window/monitor/region). It distinguishes itself from siblings by emphasizing pixels and the alternative control_computer for semantic structure or actions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines5/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives explicit when-to-use guidance ('when the result must be pixels') and names the clear alternative ('Use control_computer when semantic structure or an action is enough'). It also adds context that these operations do not interact with the visible UI, helping an agent choose correctly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
2 tool updates
v0.2.141- Changed
control_computer1 field changed- changed
Input schema / allOfPrevious value: -[ - { - "if": { - "properties": { - "operation": { - "const": "computer_snapshot" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "browser_max_nodes": { - "description": "Maximum browser accessibility nodes; default 500, maximum 2000.", - "type": "number" - }, - "grid_columns": { - "description": "Optional reference-grid column count returned as visual metadata; 0..20.", - "type": "number" - }, - "grid_rows": { - "description": "Optional reference-grid row count returned as visual metadata; 0..20.", - "type": "number" - }, - "include_browser": { - "description": "Include CDP browser accessibility when available. Default auto: only when the active app looks Chromium-based.", - "type": "boolean" - }, - "include_ocr": { - "description": "Run optional local OCR. Default auto: only when native accessibility and browser DOM are unavailable. Requires tesseract on PATH.", - "type": "boolean" - }, - "include_screenshot": { - "description": "Include real rendered desktop pixels; default true.", - "type": "boolean" - }, - "include_ui": { - "description": "Include native accessibility tree; default true. False is the fast screenshot-only path.", - "type": "boolean" - }, - "max_ui_depth": { - "description": "Maximum native accessibility depth; default 12.", - "type": "number" - }, - "max_ui_nodes": { - "description": "Maximum native accessibility nodes; default 800.", - "type": "number" - }, - "ocr_language": { - "description": "Tesseract language code, default eng; multiple languages may use eng+deu.", - "type": "string" - }, - "ocr_max_words": { - "description": "Maximum OCR word boxes returned; default 2000, maximum 10000.", - "type": "number" - }, - "ocr_psm": { - "description": "Tesseract page segmentation mode, 3..13; default 11.", - "type": "number" - }, - "ocr_timeout_ms": { - "description": "OCR timeout, default 30000 ms, maximum 120000 ms.", - "type": "number" - }, - "screenshot_monitor": { - "description": "Monitor name substring or \"primary\".", - "type": "string" - }, - "screenshot_monitor_index": { - "description": "Zero-based monitor index.", - "type": "number" - }, - "screenshot_padding": { - "description": "Pixels of context around a targeted screenshot; 0..200.", - "type": "number" - }, - "screenshot_region": { - "description": "Virtual-desktop [left,top,right,bottom] region; takes precedence over full desktop.", - "items": { - "type": "number" - }, - "maxItems": 4, - "minItems": 4, - "type": "array" - }, - "screenshot_window_id": { - "description": "Capture the window returned by list_windows instead of the whole desktop.", - "type": "string" - }, - "semantic_tree": { - "description": "Include compact semantic hierarchy text alongside nodes; default true.", - "type": "boolean" - }, - "ui_browser_dom": { - "description": "Prefer the native browser accessibility document subtree when the OS exposes one; on Windows this also enables the Firefox MSAA/IAccessible fallback.", - "type": "boolean" - }, - "ui_scope": { - "description": "Accessibility scope for computer_snapshot. Default active keeps the compact snapshot fast; desktop requests all accessible applications/windows.", - "enum": [ - "active", - "desktop" - ], - "type": "string" - } - }, - "type": "object" - } - } - } - }, - { - "if": { - "properties": { - "operation": { - "const": "computer_action" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "allOf": [ - { - "if": { - "properties": { - "action": { - "const": "click" - } - }, - "required": [ - "action" - ] - }, - "then": { - "anyOf": [ - { - "required": [ - "id" - ] - }, - { - "required": [ - "label" - ] - }, - { - "required": [ - "name" - ] - }, - { - "required": [ - "role" - ] - }, - { - "required": [ - "automation_id" - ] - }, - { - "required": [ - "selector" - ] - }, - { - "required": [ - "browser_text" - ] - }, - { - "required": [ - "ocr_text" - ] - }, - { - "required": [ - "x", - "y" - ] - } - ] - } - }, - { - "if": { - "properties": { - "action": { - "enum": [ - "invoke", - "set_value", - "select", - "toggle", - "expand", - "collapse", - "scroll_into_view", - "set_range_value", - "add_to_selection", - "remove_from_selection" - ] - } - }, - "required": [ - "action" - ] - }, - "then": { - "anyOf": [ - { - "required": [ - "id" - ] - }, - { - "required": [ - "label" - ] - }, - { - "required": [ - "name" - ] - }, - { - "required": [ - "role" - ] - }, - { - "required": [ - "automation_id" - ] - }, - { - "required": [ - "selector" - ] - }, - { - "required": [ - "browser_text" - ] - } - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "focus" - } - }, - "required": [ - "action" - ] - }, - "then": { - "anyOf": [ - { - "required": [ - "id" - ] - }, - { - "required": [ - "label" - ] - }, - { - "required": [ - "name" - ] - }, - { - "required": [ - "role" - ] - }, - { - "required": [ - "automation_id" - ] - }, - { - "required": [ - "selector" - ] - }, - { - "required": [ - "browser_text" - ] - }, - { - "required": [ - "pid" - ] - }, - { - "required": [ - "app" - ] - }, - { - "required": [ - "window_title" - ] - }, - { - "required": [ - "title" - ] - } - ] - } - }, - { - "if": { - "properties": { - "action": { - "enum": [ - "set_value", - "set_range_value" - ] - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "value" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "multi_select" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "targets" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "multi_edit" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "edits" - ] - } - } - ], - "properties": { - "action": { - "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", - "enum": [ - "click", - "invoke", - "focus", - "set_value", - "select", - "toggle", - "expand", - "collapse", - "scroll_into_view", - "set_range_value", - "add_to_selection", - "remove_from_selection", - "multi_select", - "multi_edit" - ], - "type": "string" - }, - "app": { - "description": "Limit matching to an application/process name substring when available.", - "type": "string" - }, - "automation_id": { - "description": "Windows AutomationId when available.", - "type": "string" - }, - "backend": { - "description": "Input backend preference. auto uses proven local backends and already-authorized portal input; portal explicitly requests XDG RemoteDesktop consent on Wayland; x11 forces XWayland/xdotool only for operations where read-back testing shows it is reliable. GNOME Wayland keyboard/text deliberately reject x11.", - "enum": [ - "auto", - "x11", - "portal" - ], - "type": "string" - }, - "browser_text": { - "description": "Visible browser text used to locate a DOM fallback target.", - "type": "string" - }, - "edits": { - "description": "Native semantic target + text entries for action=multi_edit.", - "items": { - "additionalProperties": false, - "properties": { - "app": { - "description": "Limit matching to an application/process name substring when available.", - "type": "string" - }, - "automation_id": { - "description": "Windows AutomationId when available.", - "type": "string" - }, - "clear": { - "description": "Clear the current value before entering text; default true.", - "type": "boolean" - }, - "id": { - "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", - "type": "string" - }, - "label": { - "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", - "type": "number" - }, - "method": { - "description": "Text-entry strategy; auto is recommended.", - "enum": [ - "auto", - "accessibility", - "clipboard", - "keys" - ], - "type": "string" - }, - "name": { - "description": "Accessible name/title substring.", - "type": "string" - }, - "pid": { - "description": "Limit matching to one owning process id when available.", - "type": "number" - }, - "role": { - "description": "Accessible role such as Button, Edit, textbox or AXButton.", - "type": "string" - }, - "text": { - "description": "Replacement text for this semantic edit.", - "type": "string" - }, - "window_title": { - "description": "Limit matching to a top-level accessibility window/frame title substring when available.", - "type": "string" - } - }, - "required": [ - "text" - ], - "type": "object" - }, - "maxItems": 100, - "minItems": 1, - "type": "array" - }, - "endpoint": { - "description": "Loopback Chrome DevTools endpoint for a browser fallback.", - "type": "string" - }, - "id": { - "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", - "type": "string" - }, - "label": { - "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", - "type": "number" - }, - "name": { - "description": "Accessible name/title substring.", - "type": "string" - }, - "ocr_language": { - "description": "Tesseract language code, default eng.", - "type": "string" - }, - "ocr_psm": { - "description": "Tesseract page segmentation mode, default 11.", - "type": "number" - }, - "ocr_region": { - "description": "Optional virtual-desktop [left,top,right,bottom] region to OCR. Prefer bounds from list_windows or computer_snapshot.", - "items": { - "type": "number" - }, - "maxItems": 4, - "minItems": 4, - "type": "array" - }, - "ocr_text": { - "description": "Visible text to find in rendered pixels for the OCR click fallback.", - "type": "string" - }, - "ocr_timeout_ms": { - "description": "OCR timeout in milliseconds.", - "type": "number" - }, - "option": { - "description": "Option value for browser select.", - "type": "string" - }, - "pid": { - "description": "Limit matching to one owning process id when available.", - "type": "number" - }, - "replace_selection": { - "description": "For multi_select, select the first item before adding the rest; default true.", - "type": "boolean" - }, - "role": { - "description": "Accessible role such as Button, Edit, textbox or AXButton.", - "type": "string" - }, - "selector": { - "description": "CSS selector when the fallback target is a browser element.", - "type": "string" - }, - "target": { - "description": "Optional target type. auto tries native accessibility first, then browser DOM/CDP, OCR text when requested, then coordinates for click.", - "enum": [ - "auto", - "ui", - "ui_element", - "browser", - "ocr", - "coordinates" - ], - "type": "string" - }, - "target_id": { - "description": "Browser page target id returned by browser_tabs.", - "type": "string" - }, - "targets": { - "description": "Native semantic targets for action=multi_select.", - "items": { - "additionalProperties": false, - "properties": { - "app": { - "description": "Limit matching to an application/process name substring when available.", - "type": "string" - }, - "automation_id": { - "description": "Windows AutomationId when available.", - "type": "string" - }, - "id": { - "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", - "type": "string" - }, - "label": { - "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", - "type": "number" - }, - "name": { - "description": "Accessible name/title substring.", - "type": "string" - }, - "pid": { - "description": "Limit matching to one owning process id when available.", - "type": "number" - }, - "role": { - "description": "Accessible role such as Button, Edit, textbox or AXButton.", - "type": "string" - }, - "window_title": { - "description": "Limit matching to a top-level accessibility window/frame title substring when available.", - "type": "string" - } - }, - "type": "object" - }, - "maxItems": 100, - "minItems": 1, - "type": "array" - }, - "text": { - "description": "Text used by multi_edit or as a compatibility value for a semantic edit.", - "type": "string" - }, - "title": { - "description": "Optional browser page title substring when target=browser.", - "type": "string" - }, - "url_contains": { - "description": "Browser URL substring used to select a page.", - "type": "string" - }, - "value": { - "description": "New value for set_value, set_range_value, or select.", - "type": "string" - }, - "window_title": { - "description": "Limit matching to a top-level accessibility window/frame title substring when available.", - "type": "string" - }, - "x": { - "description": "Virtual-desktop X coordinate used only by the final click fallback.", - "type": "number" - }, - "y": { - "description": "Virtual-desktop Y coordinate used only by the final click fallback.", - "type": "number" - } - }, - "required": [ - "action" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - } -]New value: +[ + { + "if": { + "properties": { + "operation": { + "const": "computer_snapshot" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "properties": { + "browser_max_nodes": { + "description": "Maximum browser accessibility nodes; default 500, maximum 2000.", + "type": "number" + }, + "grid_columns": { + "description": "Optional reference-grid column count returned as visual metadata; 0..20.", + "type": "number" + }, + "grid_rows": { + "description": "Optional reference-grid row count returned as visual metadata; 0..20.", + "type": "number" + }, + "include_browser": { + "description": "Include CDP browser accessibility when available. Default auto: only when the active app looks Chromium-based.", + "type": "boolean" + }, + "include_ocr": { + "description": "Run optional local OCR. Default auto: only when native accessibility and browser DOM are unavailable. Requires tesseract on PATH.", + "type": "boolean" + }, + "include_screenshot": { + "description": "Include real rendered desktop pixels; default true.", + "type": "boolean" + }, + "include_ui": { + "description": "Include native accessibility tree; default true. False is the fast screenshot-only path.", + "type": "boolean" + }, + "max_ui_depth": { + "description": "Maximum native accessibility depth; default 12.", + "type": "number" + }, + "max_ui_nodes": { + "description": "Maximum native accessibility nodes; default 800.", + "type": "number" + }, + "ocr_language": { + "description": "Tesseract language code, default eng; multiple languages may use eng+deu.", + "type": "string" + }, + "ocr_max_words": { + "description": "Maximum OCR word boxes returned; default 2000, maximum 10000.", + "type": "number" + }, + "ocr_psm": { + "description": "Tesseract page segmentation mode, 3..13; default 11.", + "type": "number" + }, + "ocr_timeout_ms": { + "description": "OCR timeout, default 30000 ms, maximum 120000 ms.", + "type": "number" + }, + "screenshot_monitor": { + "description": "Monitor name substring or \"primary\".", + "type": "string" + }, + "screenshot_monitor_index": { + "description": "Zero-based monitor index.", + "type": "number" + }, + "screenshot_padding": { + "description": "Pixels of context around a targeted screenshot; 0..200.", + "type": "number" + }, + "screenshot_region": { + "description": "Virtual-desktop [left,top,right,bottom] region; takes precedence over full desktop.", + "items": { + "type": "number" + }, + "maxItems": 4, + "minItems": 4, + "type": "array" + }, + "screenshot_window_id": { + "description": "Capture the window returned by list_windows instead of the whole desktop.", + "type": "string" + }, + "semantic_tree": { + "description": "Include compact semantic hierarchy text alongside nodes; default true.", + "type": "boolean" + }, + "ui_browser_dom": { + "description": "Prefer the native browser accessibility document subtree when the OS exposes one; on Windows this also enables the Firefox MSAA/IAccessible fallback.", + "type": "boolean" + }, + "ui_scope": { + "description": "Accessibility scope for computer_snapshot. Default active keeps the compact snapshot fast; desktop requests all accessible applications/windows.", + "enum": [ + "active", + "desktop" + ], + "type": "string" + } + }, + "type": "object" + } + } + } + }, + { + "if": { + "properties": { + "operation": { + "const": "computer_action" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "allOf": [ + { + "if": { + "properties": { + "target": { + "const": "window" + } + }, + "required": [ + "target" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "window_id" + ] + }, + { + "required": [ + "pid" + ] + }, + { + "required": [ + "app" + ] + }, + { + "required": [ + "window_title" + ] + }, + { + "required": [ + "title" + ] + } + ], + "properties": { + "action": { + "enum": [ + "type", + "focus", + "scroll", + "drag" + ] + } + } + } + }, + { + "if": { + "properties": { + "action": { + "const": "click" + } + }, + "required": [ + "action" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "ocr_text" + ] + }, + { + "required": [ + "x", + "y" + ] + } + ] + } + }, + { + "if": { + "properties": { + "action": { + "enum": [ + "invoke", + "set_value", + "select", + "toggle", + "expand", + "collapse", + "scroll_into_view", + "set_range_value", + "add_to_selection", + "remove_from_selection" + ] + } + }, + "required": [ + "action" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "name" + ] + } + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "focus" + } + }, + "required": [ + "action" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "window_id" + ] + }, + { + "required": [ + "pid" + ] + }, + { + "required": [ + "app" + ] + }, + { + "required": [ + "window_title" + ] + }, + { + "required": [ + "title" + ] + } + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "type" + } + }, + "required": [ + "action" + ] + }, + "then": { + "allOf": [ + { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "window_id" + ] + }, + { + "required": [ + "pid" + ] + }, + { + "required": [ + "app" + ] + }, + { + "required": [ + "window_title" + ] + }, + { + "required": [ + "title" + ] + } + ] + }, + { + "if": { + "properties": { + "target": { + "enum": [ + "ui", + "ui_element" + ] + } + }, + "required": [ + "target" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + } + ] + } + }, + { + "if": { + "properties": { + "target": { + "const": "browser" + } + }, + "required": [ + "target" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "name" + ] + } + ] + } + } + ], + "properties": { + "target": { + "enum": [ + "auto", + "ui", + "ui_element", + "browser", + "window" + ] + } + }, + "required": [ + "text" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "scroll" + } + }, + "required": [ + "action" + ] + }, + "then": { + "allOf": [ + { + "anyOf": [ + { + "required": [ + "delta_x" + ] + }, + { + "required": [ + "delta_y" + ] + }, + { + "required": [ + "delta" + ] + }, + { + "required": [ + "direction" + ] + } + ] + }, + { + "if": { + "properties": { + "target": { + "enum": [ + "ui", + "ui_element" + ] + } + }, + "required": [ + "target" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + } + ] + } + }, + { + "if": { + "properties": { + "target": { + "const": "coordinates" + } + }, + "required": [ + "target" + ] + }, + "then": { + "required": [ + "x", + "y" + ] + } + } + ], + "properties": { + "target": { + "enum": [ + "auto", + "ui", + "ui_element", + "browser", + "coordinates", + "window" + ] + } + } + } + }, + { + "if": { + "properties": { + "action": { + "const": "drag" + } + }, + "required": [ + "action" + ] + }, + "then": { + "allOf": [ + { + "anyOf": [ + { + "required": [ + "from_id" + ] + }, + { + "required": [ + "from_x", + "from_y" + ] + } + ] + }, + { + "anyOf": [ + { + "required": [ + "to_id" + ] + }, + { + "required": [ + "to_x", + "to_y" + ] + } + ] + }, + { + "if": { + "properties": { + "target": { + "enum": [ + "ui", + "ui_element" + ] + } + }, + "required": [ + "target" + ] + }, + "then": { + "required": [ + "from_id", + "to_id" + ] + } + }, + { + "if": { + "properties": { + "target": { + "const": "coordinates" + } + }, + "required": [ + "target" + ] + }, + "then": { + "required": [ + "from_x", + "from_y", + "to_x", + "to_y" + ] + } + } + ], + "properties": { + "target": { + "enum": [ + "auto", + "ui", + "ui_element", + "coordinates", + "window" + ] + } + } + } + }, + { + "if": { + "properties": { + "action": { + "enum": [ + "set_value", + "set_range_value" + ] + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "value" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "multi_select" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "targets" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "multi_edit" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "edits" + ] + } + } + ], + "properties": { + "action": { + "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", + "enum": [ + "click", + "type", + "invoke", + "focus", + "select", + "scroll", + "drag", + "set_value", + "toggle", + "expand", + "collapse", + "scroll_into_view", + "set_range_value", + "add_to_selection", + "remove_from_selection", + "multi_select", + "multi_edit" + ], + "type": "string" + }, + "app": { + "description": "Limit matching to an application/process name substring when available.", + "type": "string" + }, + "automation_id": { + "description": "Windows AutomationId when available.", + "type": "string" + }, + "backend": { + "description": "Input backend preference. auto uses proven local backends and already-authorized portal input; portal explicitly requests XDG RemoteDesktop consent on Wayland; x11 forces XWayland/xdotool only for operations where read-back testing shows it is reliable. GNOME Wayland keyboard/text deliberately reject x11.", + "enum": [ + "auto", + "x11", + "portal" + ], + "type": "string" + }, + "browser_text": { + "description": "Visible browser text used only to locate a DOM target; for action=type, text remains the value to enter.", + "type": "string" + }, + "button": { + "description": "Pointer button to use for click/down/up or drag gestures.", + "enum": [ + "left", + "right", + "middle" + ], + "type": "string" + }, + "clear": { + "description": "For action=type, clear the current semantic/browser value before inserting text when supported.", + "type": "boolean" + }, + "delta": { + "description": "Alias for delta_y.", + "type": "number" + }, + "delta_x": { + "description": "Horizontal scroll delta; positive means right.", + "type": "number" + }, + "delta_y": { + "description": "Vertical scroll delta; positive means down.", + "type": "number" + }, + "direction": { + "description": "Human-readable scroll direction used with wheel_times instead of explicit deltas.", + "enum": [ + "up", + "down", + "left", + "right" + ], + "type": "string" + }, + "duration_ms": { + "description": "Drag movement duration.", + "type": "number" + }, + "edits": { + "description": "Native semantic target + text entries for action=multi_edit.", + "items": { + "additionalProperties": false, + "properties": { + "app": { + "description": "Limit matching to an application/process name substring when available.", + "type": "string" + }, + "automation_id": { + "description": "Windows AutomationId when available.", + "type": "string" + }, + "clear": { + "description": "Clear the current value before entering text; default true.", + "type": "boolean" + }, + "id": { + "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", + "type": "string" + }, + "label": { + "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", + "type": "number" + }, + "method": { + "description": "Text-entry strategy; auto is recommended.", + "enum": [ + "auto", + "accessibility", + "clipboard", + "keys" + ], + "type": "string" + }, + "name": { + "description": "Accessible name/title substring.", + "type": "string" + }, + "pid": { + "description": "Limit matching to one owning process id when available.", + "type": "number" + }, + "role": { + "description": "Accessible role such as Button, Edit, textbox or AXButton.", + "type": "string" + }, + "text": { + "description": "Replacement text for this semantic edit.", + "type": "string" + }, + "window_title": { + "description": "Limit matching to a top-level accessibility window/frame title substring when available.", + "type": "string" + } + }, + "required": [ + "text" + ], + "type": "object" + }, + "maxItems": 100, + "minItems": 1, + "type": "array" + }, + "endpoint": { + "description": "Loopback Chrome DevTools endpoint for a browser fallback.", + "type": "string" + }, + "from_id": { + "description": "Source semantic UI element id for action=drag.", + "type": "string" + }, + "from_x": { + "description": "Drag source X coordinate.", + "type": "number" + }, + "from_y": { + "description": "Drag source Y coordinate.", + "type": "number" + }, + "hold_ms": { + "description": "Delay after pointer down before moving during action=drag.", + "type": "number" + }, + "id": { + "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", + "type": "string" + }, + "label": { + "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", + "type": "number" + }, + "name": { + "description": "Accessible name/title substring.", + "type": "string" + }, + "ocr_language": { + "description": "Tesseract language code, default eng.", + "type": "string" + }, + "ocr_psm": { + "description": "Tesseract page segmentation mode, default 11.", + "type": "number" + }, + "ocr_region": { + "description": "Optional virtual-desktop [left,top,right,bottom] region to OCR. Prefer bounds from list_windows or computer_snapshot.", + "items": { + "type": "number" + }, + "maxItems": 4, + "minItems": 4, + "type": "array" + }, + "ocr_text": { + "description": "Visible text to find in rendered pixels for the OCR click fallback.", + "type": "string" + }, + "ocr_timeout_ms": { + "description": "OCR timeout in milliseconds.", + "type": "number" + }, + "option": { + "description": "Option value for browser select.", + "type": "string" + }, + "pid": { + "description": "Limit matching to one owning process id when available.", + "type": "number" + }, + "replace_selection": { + "description": "For multi_select, select the first item before adding the rest; default true.", + "type": "boolean" + }, + "role": { + "description": "Accessible role such as Button, Edit, textbox or AXButton.", + "type": "string" + }, + "selector": { + "description": "CSS selector when the fallback target is a browser element.", + "type": "string" + }, + "target": { + "description": "Optional target type. auto prefers native accessibility, then browser DOM/CDP, then OCR/coordinates where supported. Use window for explicit top-level window focus/text/scroll targeting.", + "enum": [ + "auto", + "ui", + "ui_element", + "browser", + "ocr", + "coordinates", + "window" + ], + "type": "string" + }, + "target_id": { + "description": "Browser page target id returned by browser_tabs.", + "type": "string" + }, + "targets": { + "description": "Native semantic targets for action=multi_select.", + "items": { + "additionalProperties": false, + "properties": { + "app": { + "description": "Limit matching to an application/process name substring when available.", + "type": "string" + }, + "automation_id": { + "description": "Windows AutomationId when available.", + "type": "string" + }, + "id": { + "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", + "type": "string" + }, + "label": { + "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", + "type": "number" + }, + "name": { + "description": "Accessible name/title substring.", + "type": "string" + }, + "pid": { + "description": "Limit matching to one owning process id when available.", + "type": "number" + }, + "role": { + "description": "Accessible role such as Button, Edit, textbox or AXButton.", + "type": "string" + }, + "window_title": { + "description": "Limit matching to a top-level accessibility window/frame title substring when available.", + "type": "string" + } + }, + "type": "object" + }, + "maxItems": 100, + "minItems": 1, + "type": "array" + }, + "text": { + "description": "Unicode text to enter for action=type, or text used by multi_edit.", + "type": "string" + }, + "title": { + "description": "Optional browser page title substring or top-level window title when target=window.", + "type": "string" + }, + "to_id": { + "description": "Destination semantic UI element id for action=drag.", + "type": "string" + }, + "to_x": { + "description": "Drag destination X coordinate.", + "type": "number" + }, + "to_y": { + "description": "Drag destination Y coordinate.", + "type": "number" + }, + "url_contains": { + "description": "Browser URL substring used to select a page.", + "type": "string" + }, + "value": { + "description": "New value for set_value, set_range_value, or select.", + "type": "string" + }, + "wheel_times": { + "description": "Number of 120-unit wheel steps for direction; 1..50.", + "type": "number" + }, + "window_id": { + "description": "Top-level window id returned by list_windows when target=window.", + "type": "string" + }, + "window_title": { + "description": "Limit matching to a top-level accessibility window/frame title substring when available.", + "type": "string" + }, + "x": { + "description": "Virtual-desktop X coordinate used by click/scroll coordinate targeting.", + "type": "number" + }, + "y": { + "description": "Virtual-desktop Y coordinate used by click/scroll coordinate targeting.", + "type": "number" + } + }, + "required": [ + "action" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + } +]
- Changed
manage_system1 field changed- changed
Output schema / oneOfPrevious value: -[ - { - "additionalProperties": false, - "properties": { - "text": { - "description": "Human-readable result of the tool call.", - "type": "string" - } - }, - "required": [ - "text" - ], - "type": "object" - }, - { - "additionalProperties": true, - "description": "Network diagnostics structured result for network. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "address_count": { - "type": "number" - }, - "address_count_returned": { - "type": "number" - }, - "addresses_truncated": { - "type": "boolean" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "dns": { - "items": { - "type": "string" - }, - "type": "array" - }, - "host": { - "type": "string" - }, - "hostname": { - "type": "string" - }, - "interface_count": { - "type": "number" - }, - "interface_count_returned": { - "type": "number" - }, - "interfaces": { - "additionalProperties": true, - "type": "object" - }, - "interfaces_truncated": { - "type": "boolean" - }, - "latency_ms": { - "type": "number" - }, - "ok": { - "type": "boolean" - }, - "port": { - "type": "number" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "servers": { - "items": { - "type": "string" - }, - "type": "array" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Installed applications structured result for installed_apps. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "items": { - "additionalProperties": true, - "description": "Installed app/package with name/version/path where available.", - "type": "object" - }, - "type": "array" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Runtime environment structured result for environment. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "arch": { - "type": "string" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "env": { - "additionalProperties": true, - "type": "object" - }, - "hostname": { - "type": "string" - }, - "node": { - "type": "string" - }, - "path": { - "type": "string" - }, - "platform": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "release": { - "type": "string" - }, - "shell": { - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - } -]New value: +[ + { + "additionalProperties": false, + "properties": { + "text": { + "description": "Human-readable result of the tool call.", + "type": "string" + } + }, + "required": [ + "text" + ], + "type": "object" + }, + { + "additionalProperties": true, + "description": "Network diagnostics structured result for network. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "address_count": { + "type": "number" + }, + "address_count_returned": { + "type": "number" + }, + "addresses_truncated": { + "type": "boolean" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "dns": { + "items": { + "type": "string" + }, + "type": "array" + }, + "host": { + "type": "string" + }, + "hostname": { + "type": "string" + }, + "interface_count": { + "type": "number" + }, + "interface_count_returned": { + "type": "number" + }, + "interfaces": { + "additionalProperties": true, + "type": "object" + }, + "interfaces_truncated": { + "type": "boolean" + }, + "latency_ms": { + "type": "number" + }, + "ok": { + "type": "boolean" + }, + "port": { + "type": "number" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "servers": { + "items": { + "type": "string" + }, + "type": "array" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Installed applications structured result for installed_apps. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "backend": { + "description": "Native inventory backend used on this platform.", + "type": "string" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "count": { + "description": "Total matching records before the requested limit.", + "type": "number" + }, + "data": { + "items": { + "additionalProperties": true, + "description": "Normalized installed app/package record.", + "properties": { + "name": { + "description": "Installed application/package name.", + "type": "string" + }, + "path": { + "description": "Installation path when available.", + "type": [ + "string", + "null" + ] + }, + "publisher": { + "description": "Publisher/maintainer/vendor when available.", + "type": [ + "string", + "null" + ] + }, + "signed_by": { + "description": "Optional macOS signing identity summary.", + "type": "string" + }, + "version": { + "description": "Installed version when available.", + "type": [ + "string", + "null" + ] + } + }, + "type": "object" + }, + "type": "array" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "returned": { + "description": "Number of records returned in data.", + "type": "number" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Runtime environment structured result for environment. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "arch": { + "type": "string" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "cwd": { + "description": "Runtime working directory.", + "type": "string" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "environment": { + "additionalProperties": true, + "description": "Sanitized environment variables when include_env=true.", + "type": "object" + }, + "home": { + "description": "Current user home directory.", + "type": "string" + }, + "node": { + "type": "string" + }, + "path_entries": { + "items": { + "description": "One PATH entry in native search order.", + "type": "string" + }, + "type": "array" + }, + "platform": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "shell": { + "description": "Configured command shell when available.", + "type": [ + "string", + "null" + ] + }, + "temp": { + "description": "Operating-system temporary directory.", + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + } +]
3 tool updates
v0.2.131- Changed
control_computer3 fields changed- changed
Input schema / allOfPrevious value: -[ - { - "if": { - "properties": { - "operation": { - "const": "computer_snapshot" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "browser_max_nodes": { - "description": "Maximum browser accessibility nodes; default 500, maximum 2000.", - "type": "number" - }, - "grid_columns": { - "description": "Optional reference-grid column count returned as visual metadata; 0..20.", - "type": "number" - }, - "grid_rows": { - "description": "Optional reference-grid row count returned as visual metadata; 0..20.", - "type": "number" - }, - "include_browser": { - "description": "Include CDP browser accessibility when available. Default auto: only when the active app looks Chromium-based.", - "type": "boolean" - }, - "include_ocr": { - "description": "Run optional local OCR. Default auto: only when native accessibility and browser DOM are unavailable. Requires tesseract on PATH.", - "type": "boolean" - }, - "include_screenshot": { - "description": "Include real rendered desktop pixels; default true.", - "type": "boolean" - }, - "include_ui": { - "description": "Include native accessibility tree; default true. False is the fast screenshot-only path.", - "type": "boolean" - }, - "max_ui_depth": { - "description": "Maximum native accessibility depth; default 12.", - "type": "number" - }, - "max_ui_nodes": { - "description": "Maximum native accessibility nodes; default 800.", - "type": "number" - }, - "ocr_language": { - "description": "Tesseract language code, default eng; multiple languages may use eng+deu.", - "type": "string" - }, - "ocr_max_words": { - "description": "Maximum OCR word boxes returned; default 2000, maximum 10000.", - "type": "number" - }, - "ocr_psm": { - "description": "Tesseract page segmentation mode, 3..13; default 11.", - "type": "number" - }, - "ocr_timeout_ms": { - "description": "OCR timeout, default 30000 ms, maximum 120000 ms.", - "type": "number" - }, - "screenshot_monitor": { - "description": "Monitor name substring or \"primary\".", - "type": "string" - }, - "screenshot_monitor_index": { - "description": "Zero-based monitor index.", - "type": "number" - }, - "screenshot_padding": { - "description": "Pixels of context around a targeted screenshot; 0..200.", - "type": "number" - }, - "screenshot_region": { - "description": "Virtual-desktop [left,top,right,bottom] region; takes precedence over full desktop.", - "items": { - "type": "number" - }, - "maxItems": 4, - "minItems": 4, - "type": "array" - }, - "screenshot_window_id": { - "description": "Capture the window returned by list_windows instead of the whole desktop.", - "type": "string" - }, - "semantic_tree": { - "description": "Include compact semantic hierarchy text alongside nodes; default true.", - "type": "boolean" - }, - "ui_browser_dom": { - "description": "Prefer the native browser accessibility document subtree when the OS exposes one; on Windows this also enables the Firefox MSAA/IAccessible fallback.", - "type": "boolean" - }, - "ui_scope": { - "description": "Accessibility scope for computer_snapshot. Default active keeps the compact snapshot fast; desktop requests all accessible applications/windows.", - "enum": [ - "active", - "desktop" - ], - "type": "string" - } - }, - "type": "object" - } - } - } - }, - { - "if": { - "properties": { - "operation": { - "const": "computer_action" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "allOf": [ - { - "if": { - "properties": { - "action": { - "const": "click" - } - }, - "required": [ - "action" - ] - }, - "then": { - "anyOf": [ - { - "required": [ - "id" - ] - }, - { - "required": [ - "label" - ] - }, - { - "required": [ - "name" - ] - }, - { - "required": [ - "role" - ] - }, - { - "required": [ - "automation_id" - ] - }, - { - "required": [ - "selector" - ] - }, - { - "required": [ - "browser_text" - ] - }, - { - "required": [ - "ocr_text" - ] - }, - { - "required": [ - "x", - "y" - ] - } - ] - } - }, - { - "if": { - "properties": { - "action": { - "enum": [ - "invoke", - "set_value", - "select", - "toggle", - "expand", - "collapse", - "scroll_into_view", - "set_range_value", - "add_to_selection", - "remove_from_selection" - ] - } - }, - "required": [ - "action" - ] - }, - "then": { - "anyOf": [ - { - "required": [ - "id" - ] - }, - { - "required": [ - "label" - ] - }, - { - "required": [ - "name" - ] - }, - { - "required": [ - "role" - ] - }, - { - "required": [ - "automation_id" - ] - }, - { - "required": [ - "selector" - ] - }, - { - "required": [ - "browser_text" - ] - } - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "focus" - } - }, - "required": [ - "action" - ] - }, - "then": { - "anyOf": [ - { - "required": [ - "id" - ] - }, - { - "required": [ - "label" - ] - }, - { - "required": [ - "name" - ] - }, - { - "required": [ - "role" - ] - }, - { - "required": [ - "automation_id" - ] - }, - { - "required": [ - "selector" - ] - }, - { - "required": [ - "browser_text" - ] - }, - { - "required": [ - "pid" - ] - }, - { - "required": [ - "app" - ] - }, - { - "required": [ - "window_title" - ] - }, - { - "required": [ - "title" - ] - } - ] - } - }, - { - "if": { - "properties": { - "action": { - "enum": [ - "set_value", - "set_range_value" - ] - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "value" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "multi_select" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "targets" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "multi_edit" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "edits" - ] - } - } - ], - "properties": { - "action": { - "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", - "enum": [ - "click", - "invoke", - "focus", - "set_value", - "select", - "toggle", - "expand", - "collapse", - "scroll_into_view", - "set_range_value", - "add_to_selection", - "remove_from_selection", - "multi_select", - "multi_edit" - ], - "type": "string" - }, - "app": { - "description": "Limit matching to an application/process name substring when available.", - "type": "string" - }, - "automation_id": { - "description": "Windows AutomationId when available.", - "type": "string" - }, - "backend": { - "description": "Input backend preference. auto uses proven local backends and already-authorized portal input; portal explicitly requests XDG RemoteDesktop consent on Wayland; x11 forces XWayland/xdotool only for operations where read-back testing shows it is reliable. GNOME Wayland keyboard/text deliberately reject x11.", - "enum": [ - "auto", - "x11", - "portal" - ], - "type": "string" - }, - "browser_text": { - "description": "Visible browser text used to locate a DOM fallback target.", - "type": "string" - }, - "edits": { - "description": "Native semantic target + text entries for action=multi_edit.", - "items": { - "additionalProperties": false, - "properties": { - "app": { - "description": "Limit matching to an application/process name substring when available.", - "type": "string" - }, - "automation_id": { - "description": "Windows AutomationId when available.", - "type": "string" - }, - "clear": { - "description": "Clear the current value before entering text; default true.", - "type": "boolean" - }, - "id": { - "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", - "type": "string" - }, - "label": { - "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", - "type": "number" - }, - "method": { - "description": "Text-entry strategy; auto is recommended.", - "enum": [ - "auto", - "accessibility", - "clipboard", - "keys" - ], - "type": "string" - }, - "name": { - "description": "Accessible name/title substring.", - "type": "string" - }, - "pid": { - "description": "Limit matching to one owning process id when available.", - "type": "number" - }, - "role": { - "description": "Accessible role such as Button, Edit, textbox or AXButton.", - "type": "string" - }, - "text": { - "description": "Replacement text for this semantic edit.", - "type": "string" - }, - "window_title": { - "description": "Limit matching to a top-level accessibility window/frame title substring when available.", - "type": "string" - } - }, - "required": [ - "text" - ], - "type": "object" - }, - "maxItems": 100, - "minItems": 1, - "type": "array" - }, - "endpoint": { - "description": "Loopback Chrome DevTools endpoint for a browser fallback.", - "type": "string" - }, - "id": { - "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", - "type": "string" - }, - "label": { - "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", - "type": "number" - }, - "name": { - "description": "Accessible name/title substring.", - "type": "string" - }, - "ocr_language": { - "description": "Tesseract language code, default eng.", - "type": "string" - }, - "ocr_psm": { - "description": "Tesseract page segmentation mode, default 11.", - "type": "number" - }, - "ocr_region": { - "description": "Optional virtual-desktop [left,top,right,bottom] region to OCR. Prefer bounds from list_windows or computer_snapshot.", - "items": { - "type": "number" - }, - "maxItems": 4, - "minItems": 4, - "type": "array" - }, - "ocr_text": { - "description": "Visible text to find in rendered pixels for the OCR click fallback.", - "type": "string" - }, - "ocr_timeout_ms": { - "description": "OCR timeout in milliseconds.", - "type": "number" - }, - "option": { - "description": "Option value for browser select.", - "type": "string" - }, - "pid": { - "description": "Limit matching to one owning process id when available.", - "type": "number" - }, - "replace_selection": { - "description": "For multi_select, select the first item before adding the rest; default true.", - "type": "boolean" - }, - "role": { - "description": "Accessible role such as Button, Edit, textbox or AXButton.", - "type": "string" - }, - "selector": { - "description": "CSS selector when the fallback target is a browser element.", - "type": "string" - }, - "target": { - "description": "Optional target type. auto tries native accessibility first, then browser DOM/CDP, OCR text when requested, then coordinates for click.", - "enum": [ - "auto", - "ui", - "ui_element", - "browser", - "ocr", - "coordinates" - ], - "type": "string" - }, - "target_id": { - "description": "Browser page target id returned by browser_tabs.", - "type": "string" - }, - "targets": { - "description": "Native semantic targets for action=multi_select.", - "items": { - "additionalProperties": false, - "properties": { - "app": { - "description": "Limit matching to an application/process name substring when available.", - "type": "string" - }, - "automation_id": { - "description": "Windows AutomationId when available.", - "type": "string" - }, - "id": { - "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", - "type": "string" - }, - "label": { - "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", - "type": "number" - }, - "name": { - "description": "Accessible name/title substring.", - "type": "string" - }, - "pid": { - "description": "Limit matching to one owning process id when available.", - "type": "number" - }, - "role": { - "description": "Accessible role such as Button, Edit, textbox or AXButton.", - "type": "string" - }, - "window_title": { - "description": "Limit matching to a top-level accessibility window/frame title substring when available.", - "type": "string" - } - }, - "type": "object" - }, - "maxItems": 100, - "minItems": 1, - "type": "array" - }, - "text": { - "description": "Text used by multi_edit or as a compatibility value for a semantic edit.", - "type": "string" - }, - "title": { - "description": "Optional browser page title substring when target=browser.", - "type": "string" - }, - "url_contains": { - "description": "Browser URL substring used to select a page.", - "type": "string" - }, - "value": { - "description": "New value for set_value, set_range_value, or select.", - "type": "string" - }, - "window_title": { - "description": "Limit matching to a top-level accessibility window/frame title substring when available.", - "type": "string" - }, - "x": { - "description": "Virtual-desktop X coordinate used only by the final click fallback.", - "type": "number" - }, - "y": { - "description": "Virtual-desktop Y coordinate used only by the final click fallback.", - "type": "number" - } - }, - "required": [ - "action" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - }, - { - "if": { - "properties": { - "operation": { - "const": "launch_app" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "anyOf": [ - { - "required": [ - "app" - ] - }, - { - "required": [ - "path" - ] - } - ], - "properties": { - "app": { - "description": "Application name, friendly Start Menu name, or executable path.", - "type": "string" - }, - "args": { - "description": "Argument array passed directly to the launched application; no shell parsing.", - "items": { - "type": "string" - }, - "type": "array" - }, - "cwd": { - "description": "Optional permitted working directory for direct executable launch.", - "type": "string" - }, - "path": { - "description": "Alias for app.", - "type": "string" - }, - "wait_for_window": { - "description": "Optional application/title substring that must appear after launch.", - "type": "string" - }, - "wait_timeout_ms": { - "description": "Maximum wait for wait_for_window; default 10000, maximum 120000.", - "type": "number" - } - }, - "type": "object" - } - } - } - }, - { - "if": { - "properties": { - "operation": { - "const": "open_path" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "path": { - "description": "File or directory to open.", - "type": "string" - } - }, - "required": [ - "path" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - }, - { - "if": { - "properties": { - "operation": { - "const": "reveal_path" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "path": { - "description": "File or directory to reveal.", - "type": "string" - } - }, - "required": [ - "path" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - } -]New value: +[ + { + "if": { + "properties": { + "operation": { + "const": "computer_snapshot" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "properties": { + "browser_max_nodes": { + "description": "Maximum browser accessibility nodes; default 500, maximum 2000.", + "type": "number" + }, + "grid_columns": { + "description": "Optional reference-grid column count returned as visual metadata; 0..20.", + "type": "number" + }, + "grid_rows": { + "description": "Optional reference-grid row count returned as visual metadata; 0..20.", + "type": "number" + }, + "include_browser": { + "description": "Include CDP browser accessibility when available. Default auto: only when the active app looks Chromium-based.", + "type": "boolean" + }, + "include_ocr": { + "description": "Run optional local OCR. Default auto: only when native accessibility and browser DOM are unavailable. Requires tesseract on PATH.", + "type": "boolean" + }, + "include_screenshot": { + "description": "Include real rendered desktop pixels; default true.", + "type": "boolean" + }, + "include_ui": { + "description": "Include native accessibility tree; default true. False is the fast screenshot-only path.", + "type": "boolean" + }, + "max_ui_depth": { + "description": "Maximum native accessibility depth; default 12.", + "type": "number" + }, + "max_ui_nodes": { + "description": "Maximum native accessibility nodes; default 800.", + "type": "number" + }, + "ocr_language": { + "description": "Tesseract language code, default eng; multiple languages may use eng+deu.", + "type": "string" + }, + "ocr_max_words": { + "description": "Maximum OCR word boxes returned; default 2000, maximum 10000.", + "type": "number" + }, + "ocr_psm": { + "description": "Tesseract page segmentation mode, 3..13; default 11.", + "type": "number" + }, + "ocr_timeout_ms": { + "description": "OCR timeout, default 30000 ms, maximum 120000 ms.", + "type": "number" + }, + "screenshot_monitor": { + "description": "Monitor name substring or \"primary\".", + "type": "string" + }, + "screenshot_monitor_index": { + "description": "Zero-based monitor index.", + "type": "number" + }, + "screenshot_padding": { + "description": "Pixels of context around a targeted screenshot; 0..200.", + "type": "number" + }, + "screenshot_region": { + "description": "Virtual-desktop [left,top,right,bottom] region; takes precedence over full desktop.", + "items": { + "type": "number" + }, + "maxItems": 4, + "minItems": 4, + "type": "array" + }, + "screenshot_window_id": { + "description": "Capture the window returned by list_windows instead of the whole desktop.", + "type": "string" + }, + "semantic_tree": { + "description": "Include compact semantic hierarchy text alongside nodes; default true.", + "type": "boolean" + }, + "ui_browser_dom": { + "description": "Prefer the native browser accessibility document subtree when the OS exposes one; on Windows this also enables the Firefox MSAA/IAccessible fallback.", + "type": "boolean" + }, + "ui_scope": { + "description": "Accessibility scope for computer_snapshot. Default active keeps the compact snapshot fast; desktop requests all accessible applications/windows.", + "enum": [ + "active", + "desktop" + ], + "type": "string" + } + }, + "type": "object" + } + } + } + }, + { + "if": { + "properties": { + "operation": { + "const": "computer_action" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "allOf": [ + { + "if": { + "properties": { + "action": { + "const": "click" + } + }, + "required": [ + "action" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "ocr_text" + ] + }, + { + "required": [ + "x", + "y" + ] + } + ] + } + }, + { + "if": { + "properties": { + "action": { + "enum": [ + "invoke", + "set_value", + "select", + "toggle", + "expand", + "collapse", + "scroll_into_view", + "set_range_value", + "add_to_selection", + "remove_from_selection" + ] + } + }, + "required": [ + "action" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + } + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "focus" + } + }, + "required": [ + "action" + ] + }, + "then": { + "anyOf": [ + { + "required": [ + "id" + ] + }, + { + "required": [ + "label" + ] + }, + { + "required": [ + "name" + ] + }, + { + "required": [ + "role" + ] + }, + { + "required": [ + "automation_id" + ] + }, + { + "required": [ + "selector" + ] + }, + { + "required": [ + "browser_text" + ] + }, + { + "required": [ + "pid" + ] + }, + { + "required": [ + "app" + ] + }, + { + "required": [ + "window_title" + ] + }, + { + "required": [ + "title" + ] + } + ] + } + }, + { + "if": { + "properties": { + "action": { + "enum": [ + "set_value", + "set_range_value" + ] + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "value" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "multi_select" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "targets" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "multi_edit" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "edits" + ] + } + } + ], + "properties": { + "action": { + "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", + "enum": [ + "click", + "invoke", + "focus", + "set_value", + "select", + "toggle", + "expand", + "collapse", + "scroll_into_view", + "set_range_value", + "add_to_selection", + "remove_from_selection", + "multi_select", + "multi_edit" + ], + "type": "string" + }, + "app": { + "description": "Limit matching to an application/process name substring when available.", + "type": "string" + }, + "automation_id": { + "description": "Windows AutomationId when available.", + "type": "string" + }, + "backend": { + "description": "Input backend preference. auto uses proven local backends and already-authorized portal input; portal explicitly requests XDG RemoteDesktop consent on Wayland; x11 forces XWayland/xdotool only for operations where read-back testing shows it is reliable. GNOME Wayland keyboard/text deliberately reject x11.", + "enum": [ + "auto", + "x11", + "portal" + ], + "type": "string" + }, + "browser_text": { + "description": "Visible browser text used to locate a DOM fallback target.", + "type": "string" + }, + "edits": { + "description": "Native semantic target + text entries for action=multi_edit.", + "items": { + "additionalProperties": false, + "properties": { + "app": { + "description": "Limit matching to an application/process name substring when available.", + "type": "string" + }, + "automation_id": { + "description": "Windows AutomationId when available.", + "type": "string" + }, + "clear": { + "description": "Clear the current value before entering text; default true.", + "type": "boolean" + }, + "id": { + "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", + "type": "string" + }, + "label": { + "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", + "type": "number" + }, + "method": { + "description": "Text-entry strategy; auto is recommended.", + "enum": [ + "auto", + "accessibility", + "clipboard", + "keys" + ], + "type": "string" + }, + "name": { + "description": "Accessible name/title substring.", + "type": "string" + }, + "pid": { + "description": "Limit matching to one owning process id when available.", + "type": "number" + }, + "role": { + "description": "Accessible role such as Button, Edit, textbox or AXButton.", + "type": "string" + }, + "text": { + "description": "Replacement text for this semantic edit.", + "type": "string" + }, + "window_title": { + "description": "Limit matching to a top-level accessibility window/frame title substring when available.", + "type": "string" + } + }, + "required": [ + "text" + ], + "type": "object" + }, + "maxItems": 100, + "minItems": 1, + "type": "array" + }, + "endpoint": { + "description": "Loopback Chrome DevTools endpoint for a browser fallback.", + "type": "string" + }, + "id": { + "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", + "type": "string" + }, + "label": { + "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", + "type": "number" + }, + "name": { + "description": "Accessible name/title substring.", + "type": "string" + }, + "ocr_language": { + "description": "Tesseract language code, default eng.", + "type": "string" + }, + "ocr_psm": { + "description": "Tesseract page segmentation mode, default 11.", + "type": "number" + }, + "ocr_region": { + "description": "Optional virtual-desktop [left,top,right,bottom] region to OCR. Prefer bounds from list_windows or computer_snapshot.", + "items": { + "type": "number" + }, + "maxItems": 4, + "minItems": 4, + "type": "array" + }, + "ocr_text": { + "description": "Visible text to find in rendered pixels for the OCR click fallback.", + "type": "string" + }, + "ocr_timeout_ms": { + "description": "OCR timeout in milliseconds.", + "type": "number" + }, + "option": { + "description": "Option value for browser select.", + "type": "string" + }, + "pid": { + "description": "Limit matching to one owning process id when available.", + "type": "number" + }, + "replace_selection": { + "description": "For multi_select, select the first item before adding the rest; default true.", + "type": "boolean" + }, + "role": { + "description": "Accessible role such as Button, Edit, textbox or AXButton.", + "type": "string" + }, + "selector": { + "description": "CSS selector when the fallback target is a browser element.", + "type": "string" + }, + "target": { + "description": "Optional target type. auto tries native accessibility first, then browser DOM/CDP, OCR text when requested, then coordinates for click.", + "enum": [ + "auto", + "ui", + "ui_element", + "browser", + "ocr", + "coordinates" + ], + "type": "string" + }, + "target_id": { + "description": "Browser page target id returned by browser_tabs.", + "type": "string" + }, + "targets": { + "description": "Native semantic targets for action=multi_select.", + "items": { + "additionalProperties": false, + "properties": { + "app": { + "description": "Limit matching to an application/process name substring when available.", + "type": "string" + }, + "automation_id": { + "description": "Windows AutomationId when available.", + "type": "string" + }, + "id": { + "description": "Element id returned by ui_snapshot or ui_find. Linux ids are stable per-process accessibility paths and legacy linux:<index> ids remain accepted.", + "type": "string" + }, + "label": { + "description": "Compact numeric label from the most recent ui_snapshot/ui_find; useful for repeated actions without repeating names or coordinates.", + "type": "number" + }, + "name": { + "description": "Accessible name/title substring.", + "type": "string" + }, + "pid": { + "description": "Limit matching to one owning process id when available.", + "type": "number" + }, + "role": { + "description": "Accessible role such as Button, Edit, textbox or AXButton.", + "type": "string" + }, + "window_title": { + "description": "Limit matching to a top-level accessibility window/frame title substring when available.", + "type": "string" + } + }, + "type": "object" + }, + "maxItems": 100, + "minItems": 1, + "type": "array" + }, + "text": { + "description": "Text used by multi_edit or as a compatibility value for a semantic edit.", + "type": "string" + }, + "title": { + "description": "Optional browser page title substring when target=browser.", + "type": "string" + }, + "url_contains": { + "description": "Browser URL substring used to select a page.", + "type": "string" + }, + "value": { + "description": "New value for set_value, set_range_value, or select.", + "type": "string" + }, + "window_title": { + "description": "Limit matching to a top-level accessibility window/frame title substring when available.", + "type": "string" + }, + "x": { + "description": "Virtual-desktop X coordinate used only by the final click fallback.", + "type": "number" + }, + "y": { + "description": "Virtual-desktop Y coordinate used only by the final click fallback.", + "type": "number" + } + }, + "required": [ + "action" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + } +] - changed
Input schema / properties / operation / enumPrevious value: -[ - "computer_snapshot", - "computer_action", - "launch_app", - "open_path", - "reveal_path" -]New value: +[ + "computer_snapshot", + "computer_action" +] - changed
Output schema / oneOfPrevious value: -[ - { - "additionalProperties": true, - "description": "Computer snapshot structured result for computer_snapshot. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "active_window": { - "additionalProperties": true, - "description": "Active top-level window when known; null when accessibility state cannot be joined to top-level window enumeration.", - "type": [ - "object", - "null" - ] - }, - "browser": { - "additionalProperties": true, - "description": "Optional browser DOM/CDP snapshot.", - "type": "object" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "clipboard": { - "additionalProperties": true, - "description": "Clipboard metadata only unless clipboard content was explicitly requested.", - "type": "object" - }, - "cursor": { - "additionalProperties": true, - "description": "Pointer position when available.", - "type": "object" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "device": { - "additionalProperties": true, - "description": "Device/platform metadata for the captured computer state.", - "type": "object" - }, - "displays": { - "description": "Display inventory used for virtual-desktop geometry.", - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "errors": { - "description": "Non-fatal sub-capture errors.", - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "fallback_chain": { - "additionalProperties": true, - "description": "Which semantic/DOM/OCR/coordinate layers were requested and available.", - "type": "object" - }, - "ocr": { - "additionalProperties": true, - "description": "Optional OCR words/metadata.", - "type": "object" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - }, - "ui": { - "additionalProperties": true, - "description": "Native accessibility snapshot and semantic tree.", - "type": "object" - }, - "windows": { - "description": "Top-level windows with stable ids/PIDs/bounds when available.", - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Computer action structured result for computer_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "action": { - "type": "string" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "capped": { - "type": "boolean" - }, - "completed": { - "type": "number" - }, - "count": { - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "ok": { - "type": "boolean" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "results": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "stopped_at": { - "type": "number" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - }, - "waited_ms": { - "type": "number" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Launch application structured result for launch_app. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "description": "Human-readable launch result and optional ready-window confirmation.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Open path structured result for open_path. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Reveal path structured result for reveal_path. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - } -]New value: +[ + { + "additionalProperties": true, + "description": "Computer snapshot structured result for computer_snapshot. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "active_window": { + "additionalProperties": true, + "description": "Active top-level window when known; null when accessibility state cannot be joined to top-level window enumeration.", + "type": [ + "object", + "null" + ] + }, + "browser": { + "additionalProperties": true, + "description": "Optional browser DOM/CDP snapshot.", + "type": "object" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "clipboard": { + "additionalProperties": true, + "description": "Clipboard metadata only unless clipboard content was explicitly requested.", + "type": "object" + }, + "cursor": { + "additionalProperties": true, + "description": "Pointer position when available.", + "type": "object" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "device": { + "additionalProperties": true, + "description": "Device/platform metadata for the captured computer state.", + "type": "object" + }, + "displays": { + "description": "Display inventory used for virtual-desktop geometry.", + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "errors": { + "description": "Non-fatal sub-capture errors.", + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "fallback_chain": { + "additionalProperties": true, + "description": "Which semantic/DOM/OCR/coordinate layers were requested and available.", + "type": "object" + }, + "ocr": { + "additionalProperties": true, + "description": "Optional OCR words/metadata.", + "type": "object" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + }, + "ui": { + "additionalProperties": true, + "description": "Native accessibility snapshot and semantic tree.", + "type": "object" + }, + "windows": { + "description": "Top-level windows with stable ids/PIDs/bounds when available.", + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Computer action structured result for computer_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "action": { + "type": "string" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "capped": { + "type": "boolean" + }, + "completed": { + "type": "number" + }, + "count": { + "type": "number" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "ok": { + "type": "boolean" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "results": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "stopped_at": { + "type": "number" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + }, + "waited_ms": { + "type": "number" + } + }, + "type": "object" + } +]
- Changed
manage_documents3 fields changed- changed
Input schema / allOfPrevious value: -[ - { - "if": { - "properties": { - "operation": { - "const": "read_document" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "max_cells": { - "description": "Maximum number of spreadsheet cells to return.", - "type": "number" - }, - "path": { - "description": "Document path.", - "type": "string" - }, - "sheet": { - "description": "Worksheet name for XLSX.", - "type": "string" - } - }, - "required": [ - "path" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - }, - { - "if": { - "properties": { - "operation": { - "const": "edit_spreadsheet" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "create": { - "description": "Create a new XLSX at path. Fails if path already exists; do not combine with output.", - "type": "boolean" - }, - "edits": { - "description": "Bounded list of spreadsheet edits; each item names a cell/range and the value(s) or formula to write.", - "items": { - "additionalProperties": false, - "properties": { - "cell": { - "description": "Single A1 cell reference.", - "type": "string" - }, - "formula": { - "description": "Optional formula; for a range it is written to each expanded cell.", - "type": "string" - }, - "range": { - "description": "Rectangular range such as A1:C3.", - "type": "string" - }, - "value": { - "description": "Scalar value for one cell or to fill a range." - }, - "values": { - "description": "2D matrix matching the range dimensions.", - "items": { - "items": {}, - "type": "array" - }, - "type": "array" - } - }, - "type": "object" - }, - "maxItems": 500, - "type": "array" - }, - "output": { - "description": "Optional output .xlsx when editing an existing workbook; defaults to replacing input.", - "type": "string" - }, - "path": { - "description": "Existing .xlsx path, or the new workbook destination when create=true.", - "type": "string" - }, - "sheet": { - "description": "Worksheet name. For create=true, defaults to Sheet1 and becomes the new workbook sheet name.", - "type": "string" - } - }, - "required": [ - "path", - "edits" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - }, - { - "if": { - "properties": { - "operation": { - "const": "edit_document" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "create": { - "description": "Create a new DOCX at path. Fails if path already exists; do not combine with output.", - "type": "boolean" - }, - "operations": { - "description": "Bounded list of structured document operations executed in order.", - "items": { - "additionalProperties": false, - "properties": { - "action": { - "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", - "enum": [ - "replace", - "append_paragraph", - "prepend_paragraph", - "insert_paragraph_before", - "insert_paragraph_after", - "delete_paragraph" - ], - "type": "string" - }, - "all": { - "description": "Apply to all matching paragraphs; default true.", - "type": "boolean" - }, - "replacement": { - "description": "Replacement text for matching document content.", - "type": "string" - }, - "search": { - "description": "Paragraph text substring for replace/insert/delete operations.", - "type": "string" - }, - "text": { - "description": "Paragraph text to append/prepend/insert.", - "type": "string" - } - }, - "required": [ - "action" - ], - "type": "object" - }, - "maxItems": 100, - "type": "array" - }, - "output": { - "description": "Optional output .docx path when editing an existing document.", - "type": "string" - }, - "path": { - "description": "Existing .docx path, or the new document destination when create=true.", - "type": "string" - } - }, - "required": [ - "path", - "operations" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - }, - { - "if": { - "properties": { - "operation": { - "const": "pdf_action" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "allOf": [ - { - "if": { - "properties": { - "action": { - "enum": [ - "annotations", - "info", - "split", - "extract_pages" - ] - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "path" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "merge" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "paths", - "output" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "extract_pages" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "pages", - "output" - ] - } - } - ], - "properties": { - "action": { - "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", - "enum": [ - "merge", - "split", - "extract_pages", - "annotations", - "info" - ], - "type": "string" - }, - "output": { - "description": "Optional permitted output path; when omitted the tool may update the input according to its action.", - "type": "string" - }, - "output_dir": { - "description": "Permitted directory for generated output files.", - "type": "string" - }, - "pages": { - "description": "Page list/ranges such as 1-3,5.", - "type": "string" - }, - "path": { - "description": "Permitted local filesystem path.", - "type": "string" - }, - "paths": { - "description": "List of permitted local filesystem paths.", - "items": { - "type": "string" - }, - "maxItems": 100, - "minItems": 2, - "type": "array" - }, - "pattern": { - "description": "Output filename pattern where supported.", - "type": "string" - } - }, - "required": [ - "action" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - } -]New value: +[ + { + "if": { + "properties": { + "operation": { + "const": "read_document" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "properties": { + "max_cells": { + "description": "Maximum number of spreadsheet cells to return.", + "type": "number" + }, + "path": { + "description": "Document path.", + "type": "string" + }, + "sheet": { + "description": "Worksheet name for XLSX.", + "type": "string" + } + }, + "required": [ + "path" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + }, + { + "if": { + "properties": { + "operation": { + "const": "pdf_action" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "allOf": [ + { + "if": { + "properties": { + "action": { + "enum": [ + "annotations", + "info", + "split", + "extract_pages" + ] + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "path" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "merge" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "paths", + "output" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "extract_pages" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "pages", + "output" + ] + } + } + ], + "properties": { + "action": { + "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", + "enum": [ + "merge", + "split", + "extract_pages", + "annotations", + "info" + ], + "type": "string" + }, + "output": { + "description": "Optional permitted output path; when omitted the tool may update the input according to its action.", + "type": "string" + }, + "output_dir": { + "description": "Permitted directory for generated output files.", + "type": "string" + }, + "pages": { + "description": "Page list/ranges such as 1-3,5.", + "type": "string" + }, + "path": { + "description": "Permitted local filesystem path.", + "type": "string" + }, + "paths": { + "description": "List of permitted local filesystem paths.", + "items": { + "type": "string" + }, + "maxItems": 100, + "minItems": 2, + "type": "array" + }, + "pattern": { + "description": "Output filename pattern where supported.", + "type": "string" + } + }, + "required": [ + "action" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + } +] - changed
Input schema / properties / operation / enumPrevious value: -[ - "read_document", - "edit_spreadsheet", - "edit_document", - "pdf_action" -]New value: +[ + "read_document", + "pdf_action" +] - changed
Output schema / oneOfPrevious value: -[ - { - "additionalProperties": true, - "description": "Read document structured result for read_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "cells": { - "items": {}, - "type": "array" - }, - "data": {}, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "rows": { - "items": {}, - "type": "array" - }, - "sheet": { - "type": "string" - }, - "sheets": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "text": { - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Edit spreadsheet structured result for edit_spreadsheet. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "created": { - "type": "boolean" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "edited_cells": { - "type": "number" - }, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "sheet": { - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Edit DOCX document structured result for edit_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "changes": { - "type": "number" - }, - "created": { - "type": "boolean" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "operations": { - "type": "number" - }, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "PDF action structured result for pdf_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "action": { - "type": "string" - }, - "annotation_count": { - "description": "Number of PDF annotations found by the info action.", - "type": "number" - }, - "annotations": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "files": { - "items": { - "type": "string" - }, - "type": "array" - }, - "inputs": { - "type": "number" - }, - "output": { - "type": "string" - }, - "output_dir": { - "type": "string" - }, - "pages": { - "type": "string" - }, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "source": { - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - } -]New value: +[ + { + "additionalProperties": true, + "description": "Read document structured result for read_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "cells": { + "items": {}, + "type": "array" + }, + "data": {}, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "rows": { + "items": {}, + "type": "array" + }, + "sheet": { + "type": "string" + }, + "sheets": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "text": { + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "PDF action structured result for pdf_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "action": { + "type": "string" + }, + "annotation_count": { + "description": "Number of PDF annotations found by the info action.", + "type": "number" + }, + "annotations": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "files": { + "items": { + "type": "string" + }, + "type": "array" + }, + "inputs": { + "type": "number" + }, + "output": { + "type": "string" + }, + "output_dir": { + "type": "string" + }, + "pages": { + "type": "string" + }, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "source": { + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + } +]
- Changed
manage_system1 field changed- changed
Output schema / oneOfPrevious value: -[ - { - "additionalProperties": false, - "properties": { - "text": { - "description": "Human-readable result of the tool call.", - "type": "string" - } - }, - "required": [ - "text" - ], - "type": "object" - }, - { - "additionalProperties": true, - "description": "Network diagnostics structured result for network. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "dns": { - "items": { - "type": "string" - }, - "type": "array" - }, - "host": { - "type": "string" - }, - "hostname": { - "type": "string" - }, - "interfaces": { - "additionalProperties": true, - "type": "object" - }, - "latency_ms": { - "type": "number" - }, - "ok": { - "type": "boolean" - }, - "port": { - "type": "number" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "servers": { - "items": { - "type": "string" - }, - "type": "array" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Installed applications structured result for installed_apps. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "items": { - "additionalProperties": true, - "description": "Installed app/package with name/version/path where available.", - "type": "object" - }, - "type": "array" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "Runtime environment structured result for environment. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "arch": { - "type": "string" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "env": { - "additionalProperties": true, - "type": "object" - }, - "hostname": { - "type": "string" - }, - "node": { - "type": "string" - }, - "path": { - "type": "string" - }, - "platform": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "release": { - "type": "string" - }, - "shell": { - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - } -]New value: +[ + { + "additionalProperties": false, + "properties": { + "text": { + "description": "Human-readable result of the tool call.", + "type": "string" + } + }, + "required": [ + "text" + ], + "type": "object" + }, + { + "additionalProperties": true, + "description": "Network diagnostics structured result for network. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "address_count": { + "type": "number" + }, + "address_count_returned": { + "type": "number" + }, + "addresses_truncated": { + "type": "boolean" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "dns": { + "items": { + "type": "string" + }, + "type": "array" + }, + "host": { + "type": "string" + }, + "hostname": { + "type": "string" + }, + "interface_count": { + "type": "number" + }, + "interface_count_returned": { + "type": "number" + }, + "interfaces": { + "additionalProperties": true, + "type": "object" + }, + "interfaces_truncated": { + "type": "boolean" + }, + "latency_ms": { + "type": "number" + }, + "ok": { + "type": "boolean" + }, + "port": { + "type": "number" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "servers": { + "items": { + "type": "string" + }, + "type": "array" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Installed applications structured result for installed_apps. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "items": { + "additionalProperties": true, + "description": "Installed app/package with name/version/path where available.", + "type": "object" + }, + "type": "array" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Runtime environment structured result for environment. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "arch": { + "type": "string" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "env": { + "additionalProperties": true, + "type": "object" + }, + "hostname": { + "type": "string" + }, + "node": { + "type": "string" + }, + "path": { + "type": "string" + }, + "platform": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "release": { + "type": "string" + }, + "shell": { + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + } +]
1 tool update
v0.2.112- Changed
manage_documents3 fields changed- changed
Input schema / allOfPrevious value: -[ - { - "if": { - "properties": { - "operation": { - "const": "read_document" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "properties": { - "max_cells": { - "description": "Maximum number of spreadsheet cells to return.", - "type": "number" - }, - "path": { - "description": "Document path.", - "type": "string" - }, - "sheet": { - "description": "Worksheet name for XLSX.", - "type": "string" - } - }, - "required": [ - "path" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - }, - { - "if": { - "properties": { - "operation": { - "const": "pdf_action" - } - }, - "required": [ - "operation" - ] - }, - "then": { - "properties": { - "parameters": { - "additionalProperties": false, - "allOf": [ - { - "if": { - "properties": { - "action": { - "enum": [ - "annotations", - "info", - "split", - "extract_pages" - ] - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "path" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "merge" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "paths", - "output" - ] - } - }, - { - "if": { - "properties": { - "action": { - "const": "extract_pages" - } - }, - "required": [ - "action" - ] - }, - "then": { - "required": [ - "pages", - "output" - ] - } - } - ], - "properties": { - "action": { - "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", - "enum": [ - "merge", - "split", - "extract_pages", - "annotations", - "info" - ], - "type": "string" - }, - "output": { - "description": "Optional permitted output path; when omitted the tool may update the input according to its action.", - "type": "string" - }, - "output_dir": { - "description": "Permitted directory for generated output files.", - "type": "string" - }, - "pages": { - "description": "Page list/ranges such as 1-3,5.", - "type": "string" - }, - "path": { - "description": "Permitted local filesystem path.", - "type": "string" - }, - "paths": { - "description": "List of permitted local filesystem paths.", - "items": { - "type": "string" - }, - "maxItems": 100, - "minItems": 2, - "type": "array" - }, - "pattern": { - "description": "Output filename pattern where supported.", - "type": "string" - } - }, - "required": [ - "action" - ], - "type": "object" - } - }, - "required": [ - "parameters" - ] - } - } -]New value: +[ + { + "if": { + "properties": { + "operation": { + "const": "read_document" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "properties": { + "max_cells": { + "description": "Maximum number of spreadsheet cells to return.", + "type": "number" + }, + "path": { + "description": "Document path.", + "type": "string" + }, + "sheet": { + "description": "Worksheet name for XLSX.", + "type": "string" + } + }, + "required": [ + "path" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + }, + { + "if": { + "properties": { + "operation": { + "const": "edit_spreadsheet" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "properties": { + "create": { + "description": "Create a new XLSX at path. Fails if path already exists; do not combine with output.", + "type": "boolean" + }, + "edits": { + "description": "Bounded list of spreadsheet edits; each item names a cell/range and the value(s) or formula to write.", + "items": { + "additionalProperties": false, + "properties": { + "cell": { + "description": "Single A1 cell reference.", + "type": "string" + }, + "formula": { + "description": "Optional formula; for a range it is written to each expanded cell.", + "type": "string" + }, + "range": { + "description": "Rectangular range such as A1:C3.", + "type": "string" + }, + "value": { + "description": "Scalar value for one cell or to fill a range." + }, + "values": { + "description": "2D matrix matching the range dimensions.", + "items": { + "items": {}, + "type": "array" + }, + "type": "array" + } + }, + "type": "object" + }, + "maxItems": 500, + "type": "array" + }, + "output": { + "description": "Optional output .xlsx when editing an existing workbook; defaults to replacing input.", + "type": "string" + }, + "path": { + "description": "Existing .xlsx path, or the new workbook destination when create=true.", + "type": "string" + }, + "sheet": { + "description": "Worksheet name. For create=true, defaults to Sheet1 and becomes the new workbook sheet name.", + "type": "string" + } + }, + "required": [ + "path", + "edits" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + }, + { + "if": { + "properties": { + "operation": { + "const": "edit_document" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "properties": { + "create": { + "description": "Create a new DOCX at path. Fails if path already exists; do not combine with output.", + "type": "boolean" + }, + "operations": { + "description": "Bounded list of structured document operations executed in order.", + "items": { + "additionalProperties": false, + "properties": { + "action": { + "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", + "enum": [ + "replace", + "append_paragraph", + "prepend_paragraph", + "insert_paragraph_before", + "insert_paragraph_after", + "delete_paragraph" + ], + "type": "string" + }, + "all": { + "description": "Apply to all matching paragraphs; default true.", + "type": "boolean" + }, + "replacement": { + "description": "Replacement text for matching document content.", + "type": "string" + }, + "search": { + "description": "Paragraph text substring for replace/insert/delete operations.", + "type": "string" + }, + "text": { + "description": "Paragraph text to append/prepend/insert.", + "type": "string" + } + }, + "required": [ + "action" + ], + "type": "object" + }, + "maxItems": 100, + "type": "array" + }, + "output": { + "description": "Optional output .docx path when editing an existing document.", + "type": "string" + }, + "path": { + "description": "Existing .docx path, or the new document destination when create=true.", + "type": "string" + } + }, + "required": [ + "path", + "operations" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + }, + { + "if": { + "properties": { + "operation": { + "const": "pdf_action" + } + }, + "required": [ + "operation" + ] + }, + "then": { + "properties": { + "parameters": { + "additionalProperties": false, + "allOf": [ + { + "if": { + "properties": { + "action": { + "enum": [ + "annotations", + "info", + "split", + "extract_pages" + ] + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "path" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "merge" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "paths", + "output" + ] + } + }, + { + "if": { + "properties": { + "action": { + "const": "extract_pages" + } + }, + "required": [ + "action" + ] + }, + "then": { + "required": [ + "pages", + "output" + ] + } + } + ], + "properties": { + "action": { + "description": "Operation to perform; choose the narrowest action that directly matches the requested outcome.", + "enum": [ + "merge", + "split", + "extract_pages", + "annotations", + "info" + ], + "type": "string" + }, + "output": { + "description": "Optional permitted output path; when omitted the tool may update the input according to its action.", + "type": "string" + }, + "output_dir": { + "description": "Permitted directory for generated output files.", + "type": "string" + }, + "pages": { + "description": "Page list/ranges such as 1-3,5.", + "type": "string" + }, + "path": { + "description": "Permitted local filesystem path.", + "type": "string" + }, + "paths": { + "description": "List of permitted local filesystem paths.", + "items": { + "type": "string" + }, + "maxItems": 100, + "minItems": 2, + "type": "array" + }, + "pattern": { + "description": "Output filename pattern where supported.", + "type": "string" + } + }, + "required": [ + "action" + ], + "type": "object" + } + }, + "required": [ + "parameters" + ] + } + } +] - changed
Input schema / properties / operation / enumPrevious value: -[ - "read_document", - "pdf_action" -]New value: +[ + "read_document", + "edit_spreadsheet", + "edit_document", + "pdf_action" +] - changed
Output schema / oneOfPrevious value: -[ - { - "additionalProperties": true, - "description": "Read document structured result for read_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "cells": { - "items": {}, - "type": "array" - }, - "data": {}, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "rows": { - "items": {}, - "type": "array" - }, - "sheet": { - "type": "string" - }, - "sheets": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "text": { - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "PDF action structured result for pdf_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "action": { - "type": "string" - }, - "annotation_count": { - "description": "Number of PDF annotations found by the info action.", - "type": "number" - }, - "annotations": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "files": { - "items": { - "type": "string" - }, - "type": "array" - }, - "inputs": { - "type": "number" - }, - "output": { - "type": "string" - }, - "output_dir": { - "type": "string" - }, - "pages": { - "type": "string" - }, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "source": { - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - } -]New value: +[ + { + "additionalProperties": true, + "description": "Read document structured result for read_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "cells": { + "items": {}, + "type": "array" + }, + "data": {}, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "rows": { + "items": {}, + "type": "array" + }, + "sheet": { + "type": "string" + }, + "sheets": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "text": { + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Edit spreadsheet structured result for edit_spreadsheet. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "created": { + "type": "boolean" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "edited_cells": { + "type": "number" + }, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "sheet": { + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "Edit DOCX document structured result for edit_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "changes": { + "type": "number" + }, + "created": { + "type": "boolean" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "operations": { + "type": "number" + }, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "PDF action structured result for pdf_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "action": { + "type": "string" + }, + "annotation_count": { + "description": "Number of PDF annotations found by the info action.", + "type": "number" + }, + "annotations": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "files": { + "items": { + "type": "string" + }, + "type": "array" + }, + "inputs": { + "type": "number" + }, + "output": { + "type": "string" + }, + "output_dir": { + "type": "string" + }, + "pages": { + "type": "string" + }, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "source": { + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + } +]
1 tool update
v0.2.106- Changed
manage_documents1 field changed- changed
Output schema / oneOfPrevious value: -[ - { - "additionalProperties": true, - "description": "Read document structured result for read_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "cells": { - "items": {}, - "type": "array" - }, - "data": {}, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "rows": { - "items": {}, - "type": "array" - }, - "sheet": { - "type": "string" - }, - "sheets": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "text": { - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - }, - { - "additionalProperties": true, - "description": "PDF action structured result for pdf_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", - "properties": { - "action": { - "type": "string" - }, - "annotations": { - "items": { - "additionalProperties": true, - "type": "object" - }, - "type": "array" - }, - "bytes": { - "description": "Serialized structured-result size when truncation metadata is returned.", - "type": "number" - }, - "data": { - "description": "Array/scalar payload wrapper used when the natural result is not an object." - }, - "files": { - "items": { - "type": "string" - }, - "type": "array" - }, - "inputs": { - "type": "number" - }, - "output": { - "type": "string" - }, - "output_dir": { - "type": "string" - }, - "pages": { - "type": "string" - }, - "path": { - "type": "string" - }, - "preview": { - "description": "Bounded JSON preview when the full structured mirror is too large.", - "type": "string" - }, - "source": { - "type": "string" - }, - "text": { - "description": "Human-readable structured mirror for text-only results.", - "type": "string" - }, - "truncated": { - "description": "True when the structured mirror was bounded because the result was large.", - "type": "boolean" - } - }, - "type": "object" - } -]New value: +[ + { + "additionalProperties": true, + "description": "Read document structured result for read_document. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "cells": { + "items": {}, + "type": "array" + }, + "data": {}, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "rows": { + "items": {}, + "type": "array" + }, + "sheet": { + "type": "string" + }, + "sheets": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "text": { + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + }, + { + "additionalProperties": true, + "description": "PDF action structured result for pdf_action. Stable fields are declared explicitly; platform-specific fields may be added. Large results may return truncated/bytes/preview instead of the full payload.", + "properties": { + "action": { + "type": "string" + }, + "annotation_count": { + "description": "Number of PDF annotations found by the info action.", + "type": "number" + }, + "annotations": { + "items": { + "additionalProperties": true, + "type": "object" + }, + "type": "array" + }, + "bytes": { + "description": "Serialized structured-result size when truncation metadata is returned.", + "type": "number" + }, + "data": { + "description": "Array/scalar payload wrapper used when the natural result is not an object." + }, + "files": { + "items": { + "type": "string" + }, + "type": "array" + }, + "inputs": { + "type": "number" + }, + "output": { + "type": "string" + }, + "output_dir": { + "type": "string" + }, + "pages": { + "type": "string" + }, + "path": { + "type": "string" + }, + "preview": { + "description": "Bounded JSON preview when the full structured mirror is too large.", + "type": "string" + }, + "source": { + "type": "string" + }, + "text": { + "description": "Human-readable structured mirror for text-only results.", + "type": "string" + }, + "truncated": { + "description": "True when the structured mirror was bounded because the result was large.", + "type": "boolean" + } + }, + "type": "object" + } +]
59 tool updates
v0.2.88- Removed
apply_patch - Removed
computer_action - Removed
computer_snapshot - Added
control_computer - Removed
copy_file - Removed
copy_paths - Removed
create_archive - Removed
create_directory - Removed
delete_path - Removed
delete_paths - Removed
diff_files - Removed
edit_block - Removed
environment - Removed
extract_archive - Removed
force_terminate - Removed
get_file_info - Removed
get_more_search_results - Removed
get_runtime_info - Removed
get_runtime_stats - Removed
get_system_info - Removed
hash_file - Removed
installed_apps - Removed
interact_with_process - Removed
kill_process - Removed
launch_app - Removed
list_directory - Removed
list_processes - Removed
list_searches - Removed
list_sessions - Added
manage_documents - Added
manage_files - Added
manage_system - Removed
move_file - Removed
move_paths - Removed
move_to_trash - Removed
network - Removed
open_path - Removed
pdf_action - Removed
read_binary - Removed
read_document - Removed
read_files - Removed
read_image - Removed
read_multiple_files - Removed
read_process_output - Removed
replace_in_files - Removed
replace_lines - Removed
reveal_path - Added
run_terminal - Removed
set_config_value - Removed
set_permissions - Removed
start_process - Removed
start_search - Removed
stop_search - Removed
take_screenshot - Added
view_image - Removed
wait_for_process_output - Removed
write_binary - Removed
write_file - Removed
write_files
54 tool updates
v0.1.0- First observed
apply_patch - First observed
computer_action - First observed
computer_snapshot - First observed
copy_file - First observed
copy_paths - First observed
create_archive - First observed
create_directory - First observed
delete_path - First observed
delete_paths - First observed
diff_files - First observed
edit_block - First observed
environment - First observed
extract_archive - First observed
force_terminate - First observed
get_file_info - First observed
get_more_search_results - First observed
get_runtime_info - First observed
get_runtime_stats - First observed
get_system_info - First observed
hash_file - First observed
installed_apps - First observed
interact_with_process - First observed
kill_process - First observed
launch_app - First observed
list_directory - First observed
list_processes - First observed
list_searches - First observed
list_sessions - First observed
move_file - First observed
move_paths - First observed
move_to_trash - First observed
network - First observed
open_path - First observed
pdf_action - First observed
read_binary - First observed
read_document - First observed
read_file - First observed
read_files - First observed
read_image - First observed
read_multiple_files - First observed
read_process_output - First observed
replace_in_files - First observed
replace_lines - First observed
reveal_path - First observed
set_config_value - First observed
set_permissions - First observed
start_process - First observed
start_search - First observed
stop_search - First observed
take_screenshot - First observed
wait_for_process_output - First observed
write_binary - First observed
write_file - First observed
write_files
TDQS
A4.4/5.0
Scored across 7 tools
Disambiguation4/5
Tools have largely distinct primary purposes, but some overlap exists: read_file retains legacy .docx/.pdf support overlapping manage_documents, manage_files includes read operations overlapping read_file, and control_computer can capture screen overlapping view_image. Descriptions explicitly disambiguate, reducing but not eliminating confusion.
Naming Consistency5/5
All tool names follow a consistent verb_noun snake_case pattern (control_computer, manage_system, read_file, run_terminal, view_image). The verbs vary appropriately by action but the structure is uniform.
Tool Count5/5
7 tools provide a well-scoped set for a remote computer control server, covering major domains without excessive fragmentation or missing areas. Each tool earns its place.
Completeness5/5
The surface covers a comprehensive range: desktop control, system management, document handling, file operations, text reading, terminal sessions, and image viewing/capture. CRUD and lifecycle operations appear covered across domains, with no obvious dead ends.
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Remote MCP server for OFAC screening, EDD memos, exposure forecasts, queues, and reports.
Secure tunneling, reverse proxy and remote access for local applications.
Remote MCP server for Tandem docs, install guides, SDKs, workflows, and agent setup help.
Termalin's hosted MCP server. Claude, ChatGPT or any MCP client runs commands, moves files over SFTP, queries databases and reads server metrics and monitoring alerts on your servers, keylessly through Termalin Connectors: no SSH key is handed over and no inbound port is opened. Per-host command policy and an audit log. Needs a termal.in Pro or Team account (new accounts start with a 14-day Pro trial).
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables an MCP client to safely access selected local files and trusted executables with policy control, audit, and rollback via a Windows control center.Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables MCP clients to connect to a local workspace over a public tunnel and lets them run shell commands and transfer files bidirectionally.262 npm21GPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables remote MCP clients to access local MCP servers and command-line tools over the web, with user approval required for every connection.1MIT