---
title: "Every ToolPiper MCP Tool — Searchable Catalog of 300+ Tools"
description: "The full catalog of built-in ToolPiper MCP tools. Searchable, organized by category, with the unlock tier for every tool — LLM inference, browser automation, macOS system actions, video, RAG, and more."
canonical: "https://modelpiper.com/mcp/tools"
---

# Every ToolPiper MCP Tool — Searchable Catalog of 300+ Tools

> The full catalog of built-in ToolPiper MCP tools. Searchable, organized by category, with the unlock tier for every tool — LLM inference, browser automation, macOS system actions, video, RAG, and more.

ToolPiper MCP Server

# All 422 tools.

Every built-in tool in the ToolPiper MCP server, across 14 categories. Most run free on-device; the rest carry a badge for the tier that unlocks them.

Free$0/mo 359 toolsEverything on-device by default: chat, files, browser, system, vision, most media.Pro$10/mo 5 toolsRAG document search and ingestion, web scrape, YouTube transcripts.Studio$29/mo 38 toolsVideo editing and upscale, image upscale, pose tracking, outreach (GitHub, GSC, HN, Reddit).Max$49/mo 20 toolsEverything in Studio, plus Code, PiperTest, and API discovery and replay.

Enforced at the API: a tool below your tier returns a 402 upgrade prompt. Tap a tier to filter.

422 of 422 tools

[Core 33](/mcp/tools#core) [Analysis 48](/mcp/tools#analysis) [Browser 32](/mcp/tools#browser) [Filesystem 24](/mcp/tools#filesystem) [Capture 3](/mcp/tools#capture) [Testing 6](/mcp/tools#testing) [Motion 5](/mcp/tools#motion) [Outreach 15](/mcp/tools#outreach) [Search 3](/mcp/tools#search) [Sieve 4](/mcp/tools#sieve) [System 180](/mcp/tools#system) [Video 58](/mcp/tools#video) [Video Tools 7](/mcp/tools#mediaTools) [OAuth 4](/mcp/tools#oauth)

## Core

33

LLM inference, voice chat, TTS, STT, models, embeddings, OCR

`audio_speak`Convert text to speech and save as a WAV file.

`audio_transcribe`Transcribe an audio file (WAV, MP3, M4A, FLAC) to text using on-device speech recognition.

`audio_voice_clone`Generate speech using a cloned voice from a reference audio sample.

`chat`Run a prompt through a local LLM on this machine via ToolPiper.

`claude_code_install`MaxInstall the bundled claude-tp helper so the user can run \`claude-tp\` in their terminal to launch Claude Code with ToolPiper as the inference backend and ToolPiper's MCP tools mounted.

`claude_code_status`Read-only diagnostic for the claude-tp helper installed by claude\_code\_install.

`claude_code_uninstall`MaxReverse claude\_code\_install: removes the ~/.local/bin/claude-tp symlink, deletes the helper's config file, and revokes the inference bearer.

`endpoint_list`List ToolPiper inference endpoints (LLM providers + models).

`endpoint_recommend`Suggest the best inference backend for the current conversation.

`endpoint_set`Switch the inference backend ToolPiper uses.

`endpoint_status`Show the currently active inference backend for the caller.

`model_checkpoint_add`Register the user's own pinned HuggingFace weights against a coded native media architecture family and start the download.

`model_download`Start downloading (or registering) a model, LoRA, VAE, or embedding from any source.

`model_download_cancel`Cancel an in-flight model download by its download\_id (from model\_download\_list or the response of model\_download).

`model_download_list`List active model downloads with their progress and download\_id values.

`model_list`List AI models available in ToolPiper.

`model_load`Load a model that is already downloaded into memory for inference.

`model_repo_info`Fetch metadata, the full file list, a recommended variant, and (for community sources) the license and trigger words for a specific candidate.

`model_search`Find a model, LoRA, VAE, or embedding by free-text query across a source.

`model_unload`Unload a model from memory to free RAM/VRAM.

`system_resources`Get a live snapshot of Mac hardware resources — total/used/available RAM, GPU memory (Metal allocated + max, device utilization), GPU thermal state (nominal, fair, serious, critical), ANE activity (which backends are using the Neural Engine), and chip info (name, memory bandwidth).

`system_status`Check if ToolPiper is running and get system status — loaded models, active backends, GPU thermal state, available RAM, and browser CDP connection state (connected, pageUrl).

`text_embed`Generate vector embeddings for text using a local embedding model or Apple's built-in NL embeddings (zero-setup, 512-dim).

`text_translate`Translate text between languages using Apple's on-device Translation framework.

`tool_docs`Get the full description and typed input schema for named tools.

`tool_search`Find the right tools for a task by describing what you want to do in natural language.

`vision_camera_capture`Capture a single still frame from the Mac's webcam and return it as a base64-encoded PNG (≤1280 px on the longest edge).

`vision_ocr`Extract text from an image using Apple Vision OCR.

`voice_chat_memory_add`Store a persistent fact about the user that voice chat can reference in future sessions.

`voice_chat_memory_clear`Wipe all persistent facts stored via voice\_chat\_memory\_add.

`voice_chat_session_reset`Clear the active voice chat conversation history.

`voice_chat_settings_get`Read the current voice chat configuration — endpointConfigId, TTS voice, TTS speed, tools-enabled flag, and session timeout.

`voice_chat_settings_set`Update one or more voice chat configuration fields.

## Analysis

48

Image/text analysis, RAG, PDF extraction, upscaling

`asset_delete`Permanently delete an Asset record by id and reclaim the artifact bytes it solely owns.

`asset_describe`Chat-to-feature reference transform.

`image_adjust`Studio image edit.

`image_analyze`Analyze an image using Apple Vision.

`image_black_and_white`Studio image edit.

`image_blend_masked`Studio transform — apply ANY image edit to just one REGION of an image.

`image_conditioning`Studio transform — structural-conditioning producer.

`image_crop`Studio image edit.

`image_curves`Studio image edit.

`image_cutout`Studio transform.

`image_edit`Studio transform (image-to-image), REGION-SCOPABLE.

`image_erase_region`Studio transform — GENERATIVE ERASE.

`image_fill`Studio image edit.

`image_filter`Studio image edit.

`image_flip`Studio image edit.

`image_free_transform`Studio image edit.

`image_generate`Studio transform.

`image_gradient`Studio image edit.

`image_gradient_map`Studio image edit.

`image_grayscale`Studio image edit.

`image_import`Studio ingress (Apple typed-media rich import).

`image_inpaint`Studio transform — GENERATIVE FILL of one region.

`image_invert`Studio image edit.

`image_levels`Studio image edit.

`image_mask_refine`Studio selection edit.

`image_outpaint`Studio transform — CANVAS EXTEND.

`image_perspective`Studio image edit.

`image_posterize`Studio image edit.

`image_remove_subject`Studio transform.

`image_resize`Studio image edit.

`image_rotate`Studio image edit.

`image_segment`Studio transform — the region authority.

`image_straighten`Studio image edit.

`image_text`Studio image edit.

`image_threshold`Studio image edit.

`image_to_splat`Studio transform.

`image_to_world`Studio transform.

`image_transform`Transform or edit an image file on disk — resize (including shrinking and making images smaller), crop, rotate an image, or convert image format between PNG, JPEG, HEIC, WebP, TIFF.

`image_upscale`StudioUpscale a still image using CoreML super-resolution.

`image_upscale_benchmark`Measure PiperSR upscale performance on this machine.

`image_upscale_neural`Studio transform — GENERATIVE detail upscale.

`pdf_extract`Extract text, per-page text, images, or metadata from a PDF file.

`qr_generate`Generate a scannable QR code IMAGE.

`rag_collection_list`ProList all RAG (Retrieval-Augmented Generation) document collections in ToolPiper.

`rag_ingest`ProTrigger re-indexing of a RAG collection.

`rag_query`ProSearch local knowledge base collections using semantic similarity (vector + BM25 hybrid search).

`text_analyze`Analyze text using Apple's NLP framework.

`video_import`Studio ingress (byte-to-typed-Asset video import).

## Browser

32

AX-native browser automation, scraping, assertions

`browser_action`Perform a browser action: click, fill, navigate, press key, hover, wait for element, scroll, drag and drop, upload file, fill a whole form at once, or click/move at raw coordinates.

`browser_assert`Assert a condition on the current browser page.

`browser_autofill`Trigger Chrome's autofill on form fields.

`browser_console`Get browser console messages (log, warn, error) and optionally network request logs.

`browser_coverage`Measure JavaScript and CSS code coverage.

`browser_detect`Detect the frontend framework, meta-framework, CMS, state libraries, router, and dev/prod mode on the current page.

`browser_dialog_handle`Resolve the pending JavaScript dialog.

`browser_disconnect`Disconnect the CDP debugger from Chrome.

`browser_emulate`Emulate device and environment conditions on the active Chrome tab.

`browser_eval`Execute JavaScript in the browser page and return the result.

`browser_intercept`Intercept and mock network requests.

`browser_launch`Launch Chrome with remote debugging pre-enabled — avoids the 'Allow remote debugging?' dialog.

`browser_locator`Given an element on the current page, return the canonical, ranked set of stable accessibility selectors to use in saved tests.

`browser_network`Inspect network traffic in the browser with full request/response detail.

`browser_page_close`Close a Chrome tab by its id (from browser\_page\_list).

`browser_page_list`List the open Chrome tabs the CDP debugger sees, with each tab's id, URL, and title.

`browser_page_new`Open a new Chrome tab, optionally navigating to a URL.

`browser_page_select`Switch the active Chrome tab the other browser\_\* tools operate on.

`browser_pdf`Render the current browser page to a PDF file and return its path as a resource link.

`browser_performance`Measure and audit browser performance.

`browser_record`Record user interactions as action events (clicks, fills, navigations) for test creation — not screen video (use video\_record for that).

`browser_snapshot`Get a structural snapshot of the current browser page via Chrome's accessibility engine.

`browser_status`Read the current Chrome CDP connection state, the available Chrome channels (Dev, Canary, Stable), open pages, any parked JavaScript dialog awaiting browser\_dialog\_handle (pendingDialog), and the download registry — the check-back surface for a download still inProgress when its triggering browser\_action returned (completed entries carry the managed saved path).

`browser_storage`Read and write browser storage: cookies, localStorage, sessionStorage.

`browser_viewport_resize`Set the viewport width and height for the active Chrome tab.

`browser_webauthn`Test WebAuthn/passkey flows with a virtual authenticator.

`browser_webmcp`Discover and invoke WebMCP tools that the current page exposes.

`http_request`Make a raw HTTP request to any URL — returns the HTTP status code, response headers, and raw response body (JSON, text, or bytes).

`http_request_replay`MaxReplay a discovered API endpoint with optional parameter overrides.

`web_api_discover`MaxPassively analyze already-captured browser network traffic to discover API endpoints.

`web_scrape`ProFetch a URL in a real Chrome browser and return rendered content.

`youtube_transcript`ProFetch the transcript (captions) of a YouTube video.

## Filesystem

24

File operations, archives, Git, workspace search

`archive_create`Bundle files and folders into a zip / tar / tar.gz archive.

`archive_extract`Unpack a zip / tar / tar.gz archive back into files.

`archive_list`List entries inside a zip / tar / tar.gz archive without extracting.

`code_search`grep INSIDE source files.

`file_copy`Copy a file or a directory tree to a new path, creating missing parent directories.

`file_create`Create a new file with optional initial content.

`file_create_directory`Create a directory, creating missing parent directories as needed.

`file_delete`Permanently delete a single file from the filesystem.

`file_delete_directory`Delete a directory.

`file_edit`Replace an exact, unique span of text in an existing file — the surgical alternative to rewriting the whole file with file\_write.

`file_list_directory`List a directory under \`entries\` (name, path, type, size, mtime epoch-seconds, is\_symlink, kind UTI).

`file_move`Move or rename a file or directory.

`file_pick_directory`Open a native macOS file/folder picker dialog and return the selected path with isDirectory flag.

`file_read`Read the contents of a text file as a UTF-8 string.

`file_write`Write content to a file, creating parent directories if needed.

`git_checkout`Switch to a branch, tag, or commit hash.

`git_commit`Create a git commit with the currently staged changes.

`git_diff`Show file diffs in a git repository.

`git_log`Show recent commit history for a git repository.

`git_push`Push commits to a remote repository.

`git_status`Show the working tree status of a git repository.

`system_run_command`Execute a shell command and stream stdout/stderr in real time.

`workspace_add`Grant the agent access to a directory this session by pinning it to the workspace access list.

`workspace_search`Find files and folders by filename or path prefix.

## Capture

3

Screenshots, camera capture, audio recording

`audio_record`Record audio — capture N seconds of audio to a WAV file.

`vision_color_pick`Eyedropper color picker — pick a color from anywhere on screen and get its hex code.

`vision_screenshot`Take a screenshot — capture the screen as a PNG image.

## Testing

6

PiperTest CRUD and execution

`test_delete`MaxDelete a saved PiperTest by ID.

`test_export`MaxExport a PiperTest to Playwright or Cypress code.

`test_get`MaxGet a full PiperTest by ID with all steps, AX paths, element metadata, and execution context.

`test_list`MaxList saved PiperTests with metadata (id, name, step count, last run status).

`test_run`MaxExecute a PiperTest via CDP at native speed (~10-50ms/step).

`test_save`MaxCreate or update a grouped PiperTest.

## Motion

5

Pose estimation, real-time skeleton streaming

`pose_detect`StudioDetect human body poses in an image.

`pose_format_list`StudioList available pose detection backends, renderers, and output formats.

`pose_stream_start`StudioStart the real-time pose streaming WebSocket server (on-demand) and return connection details.

`vision_stream_start`Process a live WebSocket video feed with vision processors (pose, OCR, classify, upscale, faces, barcodes).

`vision_stream_stop`Stop a running stream processing session.

## Outreach

15

GitHub, Search Console, HN, Reddit, content queue

`github_activity`StudioFetch recent activity for a GitHub repo: commits, releases, merged PRs, star/fork counts.

`github_compare`StudioCompare two Git refs (branches, tags, or SHAs) in a GitHub repo.

`github_repo_list`StudioList GitHub repositories accessible by the configured PAT (up to 100, sorted by last push).

`gsc_analytics`StudioQuery Google Search Console search analytics: clicks, impressions, CTR, position.

`gsc_inspect`StudioInspect URLs in Google Search Console: indexed?, canonical URL, last crawl date, mobile usability, rich results.

`gsc_site_list`StudioList all Google Search Console properties the account has access to.

`gsc_sitemap_list`StudioList sitemaps for a GSC property with error/warning counts, last downloaded date, and indexed URL count.

`hn_search`StudioSearch Hacker News stories and comments via Algolia.

`hn_trending_list`StudioGet trending stories from Hacker News right now.

`queue_add`StudioAdd content as a draft to the outreach queue.

`queue_list`StudioList drafts in the outreach content queue.

`queue_publish`StudioMark a queued draft as published.

`reddit_post`StudioSubmit a new post or reply on Reddit.

`reddit_search`StudioSearch Reddit posts by keyword, optionally scoped to a subreddit.

`web_search`General-purpose open-web search.

## Search

3

SERP search, autocomplete, SEO rank tracking

`serp_autocomplete`Keyword discovery via Google Suggest — returns the real autocomplete queries people search for a seed term.

`serp_rank_check`Find where specific domains rank in the live Google or Bing results for a query.

`serp_search`Capture the live Google or Bing search-results page for a query via a real browser.

## Sieve

4

MediaPiper sieve inspection, testing, healing

`sieve_heal`MaxDiscover or repair full-size image URL patterns for a domain's thumbnails using a local LLM.

`sieve_inspect`MaxGet full sieve detail for a specific domain: rule definition, canary URL pairs, mutation ops, confidence history, and health state.

`sieve_list`MaxList all cached image discovery sieves from the MediaPiper browser extension.

`sieve_test`MaxDry-run: apply the cached sieve for a domain to a specific URL.

## System

180

macOS system actions — audio, display, windows, Finder, clipboard, and more

`autopilot_history_query`Retrieve prior-iteration history (summaries, decisions, dead-ends, full diffs) for YOUR Autopilot loop's cold store.

`autopilot_resume`Answer a parked escalation and resume a paused Autopilot loop.

`autopilot_start`Kick off a goal-conditioned autonomous agent loop that drives itself across fresh headless contexts until the goal is met or a real escalation occurs.

`autopilot_status`Report the current progress, run status, criteria gap, and any parked escalation for an Autopilot loop.

`autopilot_stop`Cancel a running (or parked) Autopilot loop and mark it terminal (STOPPED).

`job_cancel`Cancels a still-running (or pending) async job by id: flips it to \`cancelled\` and stops the underlying work.

`job_result`Returns the result of a COMPLETED async job: the \`outputAssetId\` of the Asset it produced (plus the resolved Asset record with its provenance).

`job_status`Returns the current state of an async job by id: \`pending\`, \`running\` (with a progress percent), \`completed\`, \`failed\`, or \`cancelled\`.

`schedule_create`MaxArm a local schedule that fires a ToolPiper capability on a wall-clock trigger: a one-shot instant, a repeating interval, or a cron expression.

`schedule_delete`MaxRemove a schedule permanently.

`schedule_get`MaxFetch one schedule by id, including its recent run history (outcome, detail, and coalesced missed-fire count per fire).

`schedule_list`MaxList every stored schedule with its trigger, action, enabled state, next fire instant, and last-run outcome.

`schedule_run_now`MaxFire a schedule's action immediately, bypassing the trigger (manual trigger and test path).

`schedule_update`MaxEdit a schedule's name, enabled state, trigger, or action.

`system_accessibility_contrast_set`Enable or disable Increase Contrast.

`system_accessibility_reduce_motion_set`Enable or disable Reduce Motion.

`system_accessibility_state`Read current macOS accessibility state: VoiceOver, zoom, reduce motion, increase contrast.

`system_accessibility_voiceover_set`Enable or disable VoiceOver.

`system_accessibility_zoom_set`Enable or disable screen Zoom.

`system_app_assert_attribute`Assert a named AX attribute (e.g. AXValue, AXTitle) on a native macOS app element equals expected.

`system_app_assert_count`Assert the count of matching native macOS app elements equals expected.

`system_app_assert_enabled`Assert a native macOS app element is enabled (not greyed-out).

`system_app_assert_focused`Assert a native macOS app element has keyboard focus.

`system_app_assert_hidden`Assert a native macOS app element is hidden or absent.

`system_app_assert_text`Assert a native macOS app element's text equals the expected value.

`system_app_assert_visible`Assert a native macOS app element is visible.

`system_app_circuit_reset`Phase 5. reset the per-session on-device grounding circuit breaker.

`system_app_click`Click a native macOS app element.

`system_app_confirm`Press the default/confirm button in a dialog or sheet of a native macOS app.

`system_app_fill`Fill a text field in a native macOS app.

`system_app_list`List all running macOS applications with bundle IDs, names, PIDs, and active/hidden state.

`system_app_press`Press a control in a native macOS app (button, checkbox, segmented control).

`system_app_resolve`Phase 5. VLM grounding resolver (third tier of the resolver hierarchy).

`system_app_set_value`Set the value of a slider, stepper, or other AXValue-bearing element in a native macOS app.

`system_app_show_menu`Open the context menu or popup menu on a native macOS app element.

`system_app_snapshot`Get the accessibility tree of a running native macOS app — the native analogue of browser\_snapshot.

`system_appearance_accent_set`Set the system accent color.

`system_appearance_highlight_set`Set the system highlight color (used for selected text).

`system_appearance_reduce_transparency_set`Enable or disable Reduce Transparency.

`system_appearance_sidebar_size_set`Set Finder/Mail sidebar icon size.

`system_appearance_state`Read current macOS appearance state: accent color, highlight color, transparency, sidebar size.

`system_audio_device_list`List all available audio output devices on this Mac.

`system_audio_output_set`Switch the active audio output device by name or ID.

`system_audio_state`Read current audio state: volume level, mute status, current output device.

`system_batch`Execute multiple actions in a single call.

`system_bluetooth_connect`Connect to a paired Bluetooth device by MAC address.

`system_bluetooth_device_list`List paired Bluetooth devices with names, MAC addresses, and connection state.

`system_bluetooth_disconnect`Disconnect a connected Bluetooth device by MAC address.

`system_bluetooth_set`Turn Bluetooth on or off.

`system_bluetooth_state`Read Bluetooth state: power on/off, paired device count.

`system_calendar_event_create`Create a calendar event.

`system_calendar_event_delete`Delete a calendar event by ID.

`system_calendar_event_list`List calendar events in a date range.

`system_calendar_event_update`Update a calendar event by ID.

`system_calendar_list`List all macOS calendars.

`system_clipboard_clear`Clear the persistent clipboard history (pinned items survive).

`system_clipboard_delete`Delete a clipboard item by ID.

`system_clipboard_get`Get a single clipboard item by ID.

`system_clipboard_history`Browse the persistent clipboard history.

`system_clipboard_pin`Pin a clipboard item so it survives clears.

`system_clipboard_read`Read the current clipboard contents (most recent item).

`system_clipboard_restore`Restore a clipboard item to the active clipboard.

`system_clipboard_search`Fuzzy-search the persistent clipboard history (text + OCR).

`system_clipboard_unpin`Unpin a pinned clipboard item.

`system_clipboard_write`Write text, an image, or file paths to the clipboard.

`system_contact_create`Create a new contact.

`system_contact_get`Get a contact by ID.

`system_contact_search`Search macOS contacts by name.

`system_contact_update`Update an existing contact by ID.

`system_default_handler_get`Get the default app handler for a UTI type or URL scheme.

`system_default_handler_set`Set the default app handler for a UTI type or URL scheme.

`system_defaults_read`Read a macOS UserDefaults key.

`system_defaults_write`Write a macOS UserDefaults key.

`system_desktop_hot_corners`Read or set hot corner actions.

`system_desktop_screensaver_start`Start the macOS screen saver immediately.

`system_desktop_stage_manager_set`Enable or disable Stage Manager.

`system_desktop_wallpaper_get`Read the current desktop wallpaper path.

`system_desktop_wallpaper_set`Set the desktop wallpaper from an image file.

`system_display_arrange`Set the origin (x, y) for a display in the desktop arrangement.

`system_display_brightness_set`Set the screen brightness on the main display.

`system_display_dark_mode_set`Turn dark mode on or off.

`system_display_list`List all attached displays with IDs, sizes, and main-display flag.

`system_display_mirror_set`Enable or disable display mirroring.

`system_display_mode_list`List supported resolution / refresh-rate modes for a display.

`system_display_night_shift_set`Turn Night Shift on or off.

`system_display_resolution_set`Set the display resolution.

`system_display_rotate`Rotate a display to 0, 90, 180, or 270 degrees.

`system_display_state`Read current display state: brightness, dark mode, Night Shift, True Tone, resolution, mirroring.

`system_display_true_tone_set`Turn True Tone on or off.

`system_dock_app_add`Add an app to the Dock by bundle ID.

`system_dock_app_remove`Remove an app from the Dock by bundle ID.

`system_dock_autohide_set`Enable or disable Dock auto-hide.

`system_dock_magnification_set`Enable or disable Dock magnification and set its size.

`system_dock_position_set`Set Dock screen position.

`system_dock_size_set`Set Dock tile size in pixels.

`system_dock_state`Read current Dock state: position, tile size, auto-hide, magnification.

`system_finder_info`Get structured file metadata (path, name, type, size, mtime, kind/UTI, permissions, owner, tags) as JSON for a file or folder.

`system_finder_open`Open a file or folder, optionally with a specific app.

`system_finder_reveal`Reveal a file or folder in Finder (selects the item in its containing folder).

`system_finder_tags`Read or set Finder tags on a file.

`system_finder_trash`Move a file or folder to the Trash (recoverable).

`system_finder_trash_empty`Permanently delete all items currently in the Trash.

`system_focus_profile_list`List configured macOS Focus profiles.

`system_focus_set`Enable or disable Focus / Do Not Disturb.

`system_focus_state`Read current Focus / Do Not Disturb state.

`system_info`Get system info: hardware, OS version, CPU, memory.

`system_input_click`Simulate a mouse click at screen coordinates.

`system_input_drag`Simulate a mouse drag from (fromX, fromY) to (toX, toY).

`system_input_key`Simulate a key press with optional modifiers.

`system_input_move`Move the mouse cursor to screen coordinates.

`system_input_scroll`Simulate scroll wheel input.

`system_input_type`Simulate typing text character-by-character.

`system_location_current`Get current GPS location.

`system_location_status`Check location services status.

`system_lock`Lock the screen.

`system_logout`Log out the current user.

`system_media_next`Skip to the next track on the currently playing media app.

`system_media_now_playing`Read current media now-playing info (title, artist, album, position) across all macOS playback apps (Music, Spotify, YouTube, etc.).

`system_media_play_pause`Toggle play/pause on the currently playing media app.

`system_media_prev`Skip to the previous track on the currently playing media app.

`system_mute_set`Mute or unmute audio output.

`system_network_dns`Read the currently configured DNS servers.

`system_network_interface_list`List all network interfaces with names, types, IP addresses, and status.

`system_network_join`Join a Wi-Fi network by SSID.

`system_network_ping`Check connectivity to a hostname or IP address.

`system_network_scan`Scan for visible Wi-Fi networks and return their SSIDs and signal strength.

`system_network_ssid`Read the SSID of the currently joined Wi-Fi network.

`system_network_state`Read overall network state: Wi-Fi on/off, current SSID, IP, connectivity.

`system_network_wifi_set`Turn Wi-Fi on or off.

`system_notification_clear`Clear all delivered notifications from Notification Center.

`system_notification_post`Post a local macOS notification immediately.

`system_notification_schedule`Schedule a local macOS notification to fire after a delay.

`system_observe`Get a composite snapshot of the entire Mac state in one call.

`system_power_prevent_display_sleep`Prevent the display from sleeping while the Mac stays awake.

`system_power_prevent_sleep`Prevent the Mac from sleeping (caffeinate).

`system_power_state`Read battery level, charging status, and thermal state.

`system_process_frontmost`Get the currently-frontmost app.

`system_process_info`Get info about a specific process by PID or bundle id.

`system_process_kill`Terminate a process by PID.

`system_process_launch`Launch a macOS app by bundle id or display name.

`system_process_list`List running processes / apps.

`system_reminder_complete`Mark a reminder complete or uncomplete.

`system_reminder_create`Create a reminder.

`system_reminder_delete`Delete a reminder by ID.

`system_reminder_list`List reminders, optionally filtered by list.

`system_reminder_list_list`List all macOS reminder lists.

`system_restart`Restart the Mac.

`system_settings_open`Open System Settings, optionally to a specific pane.

`system_shortcut_list`List all installed macOS Shortcuts.

`system_shortcut_run`Run a macOS Shortcut by name.

`system_shutdown`Shut down the Mac.

`system_sleep`Put the Mac to sleep.

`system_spaces_delete`Delete a Mission Control space by ID.

`system_spaces_list`List all Mission Control spaces/desktops with IDs and indices.

`system_spaces_switch`Switch to a Mission Control space by 1-based index.

`system_spaces_window_move`Move a window to a different Mission Control space.

`system_storage_eject`Eject a removable volume by mount point.

`system_storage_usage`Check disk usage for a filesystem path.

`system_storage_volume_list`List mounted volumes (internal disks, external drives, network shares).

`system_timer_cancel`Cancel a specific running timer by ID.

`system_timer_clear`Cancel all running timers.

`system_timer_list`List all currently-running timers with remaining time.

`system_timer_start`Start a countdown timer that fires a macOS notification when it elapses.

`system_undo`Undo the most recent reversible action: restore a trashed file, revert a defaults write, or restore prior Finder tags / default app handler.

`system_undo_list`List the captured inverse operations available to undo, newest first.

`system_uptime`Get system uptime since last boot.

`system_url_open`Open a URL in the user's default browser or app.

`system_volume_set`Set the system output volume.

`system_window_close`Close a window.

`system_window_focus`Bring a window to the foreground and focus it.

`system_window_fullscreen_set`Enter or exit fullscreen for a window.

`system_window_layout`Apply a multi-window layout preset (side\_by\_side, stack) across the visible windows.

`system_window_list`List visible windows on macOS, optionally filtered by bundleId, pid, or title substring.

`system_window_minimize_set`Minimize or restore a window.

`system_window_move`Move a window to absolute screen coordinates (x, y) in pixels.

`system_window_resize`Resize a window to width × height in pixels.

`system_window_snap`Snap a window to a screen region (left\_half, right\_half, top\_half, bottom\_half, top\_left, top\_right, bottom\_left, bottom\_right, center, maximize).

`task_complete`Mark a task as completed.

`task_create`Create a task to track a unit of work.

`task_update`Update the status of an existing task.

## Video

58

Automated video creation pipeline

`image_to_video`Studio video transform (image-to-video) — the kernel's headline 'animate this image' verb.

`media_project_add_adjustment_layer`Adds an ADJUSTMENT layer to the TOP of a \`media-project\`'s \`image\` facet: a layer with no pixels of its own that applies one classical image verb (levels, curves, black-and-white, a filter, …) to everything BELOW it, re-evaluated at every flatten.

`media_project_add_facet`Attaches an empty facet for a medium to a \`media-project\` (a project holds at most one facet per medium).

`media_project_add_layer`Adds a raster layer to the TOP of a \`media-project\`'s \`image\` facet layer stack, referencing an existing \`image\` Asset as its content.

`media_project_add_source`Adds a REFERENCE to a source file into a \`media-project\`'s ordered source pool — the project's inputs, shared by every facet.

`media_project_create`Unified media working document.

`media_project_delete`Permanently deletes a \`media-project\` container Asset by id and reclaims the bytes it owns.

`media_project_delete_layer`Removes a layer (by its \`lyr\_...\` id) from a \`media-project\`'s \`image\` facet.

`media_project_flatten`Composites every visible layer of a \`media-project\`'s \`image\` facet into ONE new immutable \`image\` Asset (canvas = the first raster layer's native size), applying each adjustment layer to the layers below it.

`media_project_get`Returns the current state of a \`media-project\` by id: its display name, timestamps, the facets it holds (each facet's medium), and its ordered pool of referenced source files (each source's \`src\_...\` id, ref, name, and ordinal — the ids that media\_project\_remove\_source / media\_project\_reorder\_source address).

`media_project_merge_down`Merges a layer onto the one directly below it in a \`media-project\`'s \`image\` facet: composites the two, mints the merged raster as a new \`image\` Asset, and replaces both layers with one layer referencing it.

`media_project_remove_source`Removes a source (by its \`src\_...\` id) from a \`media-project\`'s pool, along with any sources nested beneath it.

`media_project_rename`Sets a \`media-project\`'s display name.

`media_project_reorder_layers`Reorders the whole layer stack of a \`media-project\`'s \`image\` facet to match the given ordered list of layer ids (must be a permutation of the current ids; index 0 is the bottom / base).

`media_project_reorder_source`Reorders a sibling group of sources in a \`media-project\`'s pool to match the given ordered list of source ids; siblings not listed keep their relative order after the listed ones.

`media_project_set_layer`Updates a layer in a \`media-project\`'s \`image\` facet — its blend mode, opacity, visibility, and name, and its CONTENT.

`media_project_set_layer_mask`Sets or clears a layer's matte in a \`media-project\`'s \`image\` facet.

`media_project_set_layer_transform`Updates a RASTER layer's 2D placement — translation (pixels, top-left origin), scale, and rotation (degrees clockwise) — in a \`media-project\`'s \`image\` facet.

`storyboard_add_shot`Studio video transform.

`storyboard_assemble`Studio video transform.

`storyboard_create`Studio video intent layer.

`storyboard_generate`Studio video transform.

`storyboard_get`Returns the current state of a storyboard \`media-project\` by id: its scenes, shots, each shot's kind / spec / clip reference / generationStatus, and stable ids.

`storyboard_remove_shot`Studio video transform.

`storyboard_reorder`Studio video transform.

`storyboard_set_shot`Studio video transform.

`storyboard_update`Studio video transform.

`text_to_video`Studio video transform.

`video_add_clip`Studio video timeline transform.

`video_clips`StudioBrowse the PiperClips library (~/Documents/PiperClips/).

`video_delete`StudioDelete a video screenplay and all associated artifacts (storyboards, recordings, narration).

`video_edit_composition`StudioEdit visual/production settings for a screenplay.

`video_edit_narration`StudioEdit narration and audio settings for a screenplay.

`video_edit_screenplay`StudioEdit a screenplay's scenes and steps.

`video_edit_timeline`StudioEdit the post-recording timeline for a screenplay.

`video_export`Exports a \`media-project\`'s timeline as an editorial interchange file for a pro NLE: OpenTimelineIO ('otio', default), Final Cut Pro XML ('fcpxml'), or CMX 3600 EDL ('edl').

`video_export_timeline`StudioExport a screenplay's edit timeline to an interchange format for use in external NLEs (Final Cut Pro, Premiere, DaVinci Resolve).

`video_get`StudioGet a full video screenplay by ID with all scenes, steps, video config, narration config, and stage results.

`video_import_media`StudioImport an external video file (screen recording, stock footage, camera footage) into a screenplay's media library.

`video_inspect`Renders composited frames of a \`media-project\`'s timeline at a frame range back to the agent so it can SEE the current edit (the agent's eyes on the timeline).

`video_list`StudioList video screenplays with metadata (id, name, stage, scene count, source ref).

`video_move_clip`Studio video timeline transform.

`video_narrate`StudioGenerate TTS narration audio for a screenplay's scenes.

`video_preview`StudioPreview a recorded screenplay.

`video_record`StudioRecord a video by executing a screenplay — drives Chrome via CDP with human-like pacing while VisionPiper captures the screen.

`video_rehearse`StudioDry-run a screenplay via CDP.

`video_remove_clip`Studio video timeline transform.

`video_render`StudioPost-process a recorded screenplay: composite with frame styling, zoom, cursor overlays, color grade.

`video_reorder`Studio video timeline transform.

`video_save`StudioCreate or update a video screenplay.

`video_segment`Studio video transform — the region authority's video door.

`video_set_clip`Studio video timeline transform.

`video_set_keyframes`Studio video timeline transform.

`video_set_render_range`Studio video timeline transform.

`video_settings`StudioGet or update default video settings (preset, voice, language, pacing, capture, branding, subtitles, sound design).

`video_split`Studio video timeline transform.

`video_timeline`Returns the current state of a \`media-project\`'s timeline: its tracks, each clip's stable id, source, in/out points, timeline position, speed, and any keyframes, plus the render range.

`video_trim`Studio video timeline transform.

## Video Tools

7

Video Tools platform: acquire, transform, serve, and capability introspection

`media_extract`Discover the playable media on a web page and return candidate URLs (HLS/DASH manifests, progressive .mp4/.webm) using ONLY generic, standards-based signals: DOM \`<video>\`/\`<source>\`, Open Graph (\`og:video\`), Twitter player, JSON-LD \`VideoObject\`, oEmbed discovery, and — over the attached browser — live network manifests.

`media_host`Host a local video file OR a captured HLS/DASH manifest as a stable, range-capable artifact and return a bearer-free URL a browser \`<video>.src\` can play directly (no Authorization header needed — the unguessable \`med\_\` id is the capability).

`stream_save`Save a captured HLS (.m3u8) or DASH (.mpd) stream to disk using AVFoundation — downloads the segments at the chosen variant (no re-encode, no ffmpeg).

`video_capabilities`List the native video layer's capability matrix: which codecs it can read, write, and mux (H.264 / HEVC / AAC are native, Opus / AC-3 re-encode the audio track, AV1 is refused, VP8 / VP9 unsupported until a later phase) and which containers it can read and write (mp4, mov, HLS, DASH, fMP4; WebM unsupported).

`video_clip`StudioTrim a \`\[start\_ms, end\_ms)\` segment out of an already-hosted video artifact (by its \`med\_\` id from media\_host) into a flat, persistent .mp4 on disk via AVFoundation passthrough (no re-encode).

`video_export_file`StudioSave an already-hosted video artifact to a real file in a user output folder — the save-to-disk / download step.

`video_upscale`StudioUpscale a video file 2x using PiperSR on Apple Neural Engine.

## OAuth

4

OAuth connection management

`oauth_connect`Start an OAuth browser consent flow for a provider (Google, Reddit, GitHub, X).

`oauth_connect_service_account`Connect a Google service account using a JSON key file.

`oauth_disconnect`Disconnect an OAuth provider.

`oauth_status`Check the authentication status of OAuth connections.

## Looking for third-party servers to install?

This page lists ToolPiper's own built-in tools. The marketplace carries curated external MCP servers (GitHub, Slack, Postgres, and more), each installable in ToolPiper with one click.

[Browse the MCP marketplace](/mcp-tools) [Back to the MCP server page →](/mcp)
