Browse the user guide

Tools reference

Every MCP tool Shotomatic offers AI agents, what each one does, which ones ask you first, and which parts need Pro.

Updated November 16, 2026

View Markdown
On this page

This page lists the MCP tools Shotomatic 1.10.1 offers an approved agent. Agents read the same list, with full input schemas, when they connect. You do not call these tools yourself; knowing them helps you phrase requests and understand what an agent reports.

Which tool for which job

You want the agent to…Tools it uses
Check permissions, plan, and running jobsget_status
See what is on screenlist_capture_sources, capture_snapshot, capture_window_snapshot
Capture a window repeatedly, with a key pressstart_auto_capture, get_job, control_job
Record a click-by-click guidestart_action_capture, get_job, control_job
Capture web pagespreview_website, capture_websites, get_job, control_job
Reuse or schedule website settingswebsite_capture_options, website_workflows
Find and look at past captureslist_capture_sessions, get_capture_session, view_images
Build and edit a Documentlist_documents, get_document, create_document, add_pages, edit_document
Get files outexport, get_job
Clean updelete_items, rename_capture_session
Change capture and export settingsupdate_settings

Long jobs return a job id right away. The agent follows the job with get_job, which waits up to 50 seconds per call, so a long capture keeps running in Shotomatic between calls.

Status and sources

get_status

Reports the app version, whether Screen Recording and Accessibility are granted, your plan and the free screenshots left today, feature limits, jobs in progress, whether the website browser is installed, and current settings. Agents call it first and again after you fix something.

list_capture_sources

Lists the windows and screens Shotomatic can capture, with their ids, names, and app names.

capture_snapshot

Takes a preview of a window or screen to confirm the right page is showing. The preview is a smaller JPEG; it is not saved to Capture History and does not use free screenshots.

capture_window_snapshot

Takes a PNG snapshot of one window and returns it to the agent. Like capture_snapshot, it is not saved.

Captures and jobs

start_auto_capture

Captures one window at a fixed interval and can press a key after each screenshot, such as the right arrow to turn a page. Shotomatic brings the window to the front and never presses a key while another window is in front or the screen is locked; the job pauses instead. With a key press, it stops by itself when the page stops changing. Stop conditions follow your plan; see Stop conditions, intervals, and keypresses.

start_action_capture

Starts an Action Capture: every click in the chosen window saves a step, and a Document is built when the capture stops. Shotomatic does not click. You perform the clicks, or an agent with its own computer-use ability does.

get_job

Checks a capture, website batch, or export started earlier and can wait for progress.

control_job

Steers a running job. Auto Capture: pause, resume, or stop, keeping screenshots already taken. Action Capture: stop and build the Document, or save a step without a click. Website batch: cancel the batch, or cancel or retry one page.

Website Capture

preview_website

Renders one URL with the given options in Shotomatic's browser and shows the agent the result, so it can tune options before a batch. The preview is not saved.

capture_websites

Captures a list of web pages, full page or viewport, on desktop, tablet, or mobile, into one Capture Session, or runs a saved Workflow now. Nothing on your screen is used. Requires the website browser; see Website Capture.

website_capture_options

Lists, reads, or saves Website Capture saved options. Agents cannot delete saved options.

website_workflows

Lists, reads, saves, pauses, or resumes Workflows. A schedule is an interval of at least 5 minutes or a daily time. Saving a Workflow with a schedule, or resuming one, waits for your confirmation; pausing does not. Scheduled runs happen only while Shotomatic is open, and runs missed while it was closed are not caught up. Agents cannot delete Workflows.

Capture History

list_capture_sessions

Lists Capture Sessions, newest first, with frame counts and the Document made from each session, if any.

get_capture_session

Reads one session: its summary, frame file paths in pages of up to 200, and, for Website Capture, each page and its status.

rename_capture_session

Renames a session as it appears in Shotomatic.

view_images

Shows the agent Capture History frames or Document pages as images, up to 6 per call and 8 MB in total. A Document page is shown without its crop or annotations. Images an agent views become part of its conversation.

Documents

list_documents

Lists Documents, most recently changed first.

get_document

Reads a Document: title, revision, Pages with their text, framing, and annotations.

create_document

Creates a Document from Capture Session frames, image files, or a blank page. Choosing a whole session that already has a Document returns that Document instead of a copy.

add_pages

Adds Pages from Capture Session frames or image files, at the end or after a given Page.

edit_document

Changes a Document in one step: title, Page titles and descriptions, framing, annotations, Page order, duplicating or deleting Pages, and watermark. If any part fails, nothing changes. Blur, marker, click marker, and watermark need Pro. If the Document is open in the editor, the editor reloads it.

Export and settings

export

Exports a Document as PDF, PNG, JPG, WebP, or ZIP, or Capture Session frames as ZIP, PNG, JPG, a searchable PDF, or MP4. Files go to your export folder under new names, existing files are never overwritten, and nothing opens on screen.

update_settings

Changes Auto Export (on or off, PNG or JPG), JPG quality, and how many sessions Capture History keeps. A lower limit that would delete sessions asks you first. The export folder, language, presets, and license cannot be changed.

Deleting

delete_items

Deletes up to 50 Documents or Capture Sessions in one request. Shotomatic shows one confirmation that lists every item and waits up to a minute for your answer. Deleting a Capture Session never deletes Documents made from it. See Approvals and confirmations.

If a tool returns an error, see Agent errors and fixes.

Tools reference | User Guide | Shotomatic