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
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 jobs | get_status |
| See what is on screen | list_capture_sources, capture_snapshot, capture_window_snapshot |
| Capture a window repeatedly, with a key press | start_auto_capture, get_job, control_job |
| Record a click-by-click guide | start_action_capture, get_job, control_job |
| Capture web pages | preview_website, capture_websites, get_job, control_job |
| Reuse or schedule website settings | website_capture_options, website_workflows |
| Find and look at past captures | list_capture_sessions, get_capture_session, view_images |
| Build and edit a Document | list_documents, get_document, create_document, add_pages, edit_document |
| Get files out | export, get_job |
| Clean up | delete_items, rename_capture_session |
| Change capture and export settings | update_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.