# Tools reference | User Guide | Shotomatic

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

- Type: Public web page
- Canonical page: [https://www.shotomatic.com/guide/ai-agents/tools](https://www.shotomatic.com/guide/ai-agents/tools)
- Markdown page: [https://www.shotomatic.com/guide/ai-agents/tools.md](https://www.shotomatic.com/guide/ai-agents/tools.md)

Browse the user guide

On this page

1.  [Which tool for which job](#which-tool-for-which-job)
2.  [Status and sources](#status-and-sources)
3.  [Captures and jobs](#captures-and-jobs)
4.  [Website Capture](#website-capture)
5.  [Capture History](#capture-history)
6.  [Documents](#documents)
7.  [Export and settings](#export-and-settings)
8.  [Deleting](#deleting)

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](https://www.shotomatic.com/guide/screenshot-capture/automated-capture).

### start\_action\_capture

Starts an [Action Capture](https://www.shotomatic.com/guide/screenshot-capture/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](https://www.shotomatic.com/guide/website-capture/quick-start).

### 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](https://www.shotomatic.com/guide/ai-agents/approvals-and-confirmations).

If a tool returns an error, see [Agent errors and fixes](https://www.shotomatic.com/guide/ai-agents/errors).

## On this page

1.  [Which tool for which job](#which-tool-for-which-job)
2.  [Status and sources](#status-and-sources)
3.  [Captures and jobs](#captures-and-jobs)
4.  [Website Capture](#website-capture)
5.  [Capture History](#capture-history)
6.  [Documents](#documents)
7.  [Export and settings](#export-and-settings)
8.  [Deleting](#deleting)

## About this version

This Markdown page is generated from the server-rendered public page on Shotomatic. Interactive controls and site navigation are omitted. Use the canonical page when citing or sharing it with people.
