ToolPiper MCP Server

All 433 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.

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

See what each tier unlocks →

Core

33

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

audio_speakProConvert text to speech and save as a WAV file.
audio_transcribeProTranscribe an audio file (WAV, MP3, M4A, FLAC) to text using on-device speech recognition.
audio_voice_cloneProGenerate speech mimicking a voice from a reference audio sample.
chatRun a prompt through a local LLM on this machine via ToolPiper.
claude_code_installInstall 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_statusRead-only diagnostic for the claude-tp helper installed by claude_code_install.
claude_code_uninstallReverse claude_code_install: removes the ~/.local/bin/claude-tp symlink, deletes the helper's config file, and revokes the inference bearer.
endpoint_listList ToolPiper inference endpoints (LLM providers + models).
endpoint_recommendSuggest the best inference backend for the current conversation.
endpoint_setSwitch the inference backend ToolPiper uses.
endpoint_statusShow the currently active inference backend for the caller.
model_checkpoint_addRegister the user's own pinned HuggingFace weights against a coded native media architecture family and start the download.
model_downloadStart downloading (or registering) a model, LoRA, VAE, or embedding from any source.
model_download_cancelCancel an in-flight model download by its download_id (from model_download_list or the response of model_download).
model_download_listList active model downloads with their progress and download_id values.
model_listList AI models available in ToolPiper.
model_loadLoad a model that is already downloaded into memory for inference.
model_repo_infoFetch metadata, the full file list, a recommended variant, and (for community sources) the license and trigger words for a specific candidate.
model_unloadUnload a model from memory to free RAM/VRAM.
system_resourcesGet 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_statusCheck 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_embedGenerate vector embeddings for text, entirely on-device.
text_translateTranslate text between languages using Apple's on-device Translation framework.
tool_docsGet the full description and typed input schema for named tools.
vision_camera_captureProCapture a single still frame from the Mac's webcam and return it as a base64-encoded PNG (≤1280 px on the longest edge).
vision_ocrProExtract text from an image using Apple Vision OCR.
voice_chat_memory_addStore a persistent fact about the user that voice chat can reference in future sessions.
voice_chat_memory_clearWipe all persistent facts stored via voice_chat_memory_add.
voice_chat_session_resetClear the active voice chat conversation history.
voice_chat_settings_getRead the current voice chat configuration — endpointConfigId, TTS voice, TTS speed, tools-enabled flag, and session timeout.
voice_chat_settings_setUpdate one or more voice chat configuration fields.

Analysis

49

Image/text analysis, RAG, PDF extraction, upscaling

asset_deleteProPermanently delete an Asset record by id and reclaim the artifact bytes it solely owns.
asset_describeProChat-to-feature reference transform.
image_adjustStudioStudio image edit.
image_analyzeProAnalyze an image using Apple Vision.
image_black_and_whiteStudioStudio image edit.
image_blend_maskedStudioStudio transform — apply ANY image edit to just one REGION of an image.
image_conditioningProStudio transform — structural-conditioning producer.
image_cropStudioStudio image edit.
image_curvesStudioStudio image edit.
image_cutoutStudioStudio transform.
image_editStudioStudio transform (image-to-image), REGION-SCOPABLE.
image_erase_regionStudioStudio transform — GENERATIVE ERASE.
image_fillProStudio image edit.
image_filterStudioStudio image edit.
image_flipStudioStudio image edit.
image_free_transformProStudio image edit.
image_generateStudioStudio transform.
image_gradientProStudio image edit.
image_gradient_mapProStudio image edit.
image_grayscaleStudioStudio image edit.
image_importProStudio ingress (Apple typed-media rich import).
image_inpaintStudioStudio transform — GENERATIVE FILL of one region.
image_invertStudioStudio image edit.
image_levelsStudioStudio image edit.
image_mask_refineStudioStudio selection edit.
image_outpaintProStudio transform — CANVAS EXTEND.
image_perspectiveProStudio image edit.
image_posterizeProStudio image edit.
image_remove_subjectStudioStudio transform.
image_resizeStudioStudio image edit.
image_rotateStudioStudio image edit.
image_segmentStudioStudio transform — the region authority.
image_straightenStudioStudio image edit.
image_textProStudio image edit.
image_thresholdProStudio image edit.
image_to_splatStudioStudio transform.
image_to_worldStudioStudio transform.
image_transformStudioTransform 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_upscaleStudioUpscale a still image using CoreML super-resolution.
image_upscale_benchmarkStudioMeasure PiperSR upscale performance on this machine.
image_upscale_neuralStudioStudio transform — GENERATIVE detail upscale.
pdf_extractExtract text, per-page text, images, or metadata from a PDF file.
qr_generateProGenerate a scannable QR code IMAGE.
rag_collection_listProList all RAG (Retrieval-Augmented Generation) document collections in ToolPiper.
rag_ingestProTrigger re-indexing of a RAG collection.
rag_queryProSearch local knowledge base collections using semantic similarity (vector + BM25 hybrid search).
text_analyzeAnalyze text using Apple's NLP framework.
video_importStudioStudio ingress (byte-to-typed-Asset video import).

Browser

30

AX-native browser automation, scraping, assertions

browser_actionProDispatch a browser interaction (see the `action` enum).
browser_assertProAssert a condition on the current browser page.
browser_autofillProTrigger Chrome's autofill on form fields.
browser_connectOwn the Chrome CDP connection lifecycle.
browser_consoleProGet browser console messages (log, warn, error) and optionally network request logs.
browser_coverageProMeasure JavaScript and CSS code coverage.
browser_detectProDetect the frontend framework, meta-framework, CMS, state libraries, router, and dev/prod mode on the current page.
browser_dialog_handleProResolve the pending JavaScript dialog.
browser_emulateProEmulate device and environment conditions on the active Chrome tab.
browser_evalProExecute JavaScript in the browser page and return the result.
browser_interceptProIntercept and mock network requests.
browser_locatorProGiven an element on the current page, return the canonical, ranked set of stable accessibility selectors to use in saved tests.
browser_networkProInspect network traffic in the browser with full request/response detail.
browser_page_closeProClose a Chrome tab by its id (from browser_page_list).
browser_page_listList the open Chrome tabs the CDP debugger sees, with each tab's id, URL, and title.
browser_page_newProOpen a new Chrome tab, optionally navigating to a URL.
browser_page_selectProSwitch the active Chrome tab the other browser_* tools operate on.
browser_pdfProRender the current browser page to a PDF file and return its path as a resource link.
browser_performanceProMeasure and audit browser performance.
browser_recordProRecord user interactions as action events (clicks, fills, navigations) for test creation — not screen video (use video_record for that).
browser_snapshotGet a structural snapshot of the current browser page via Chrome's accessibility engine.
browser_storageProRead and write browser storage: cookies, localStorage, sessionStorage.
browser_viewport_resizeProSet the viewport width and height for the active Chrome tab.
browser_webauthnProTest WebAuthn/passkey flows with a virtual authenticator.
browser_webmcpDiscover and invoke WebMCP tools that the current page exposes.
http_requestProMake a raw HTTP request to any URL — returns the HTTP status code, response headers, and raw response body (JSON, text, or bytes).
http_request_replayProReplay a discovered API endpoint with optional parameter overrides.
web_api_discoverProPassively analyze already-captured browser network traffic to discover API endpoints.
web_scrapeProFetch a URL in a real Chrome browser and return rendered content.
youtube_transcriptProFetch the transcript (captions) of a YouTube video.

Filesystem

24

File operations, archives, Git, workspace search

archive_createProBundle files and folders into a zip / tar / tar.gz archive.
archive_extractProUnpack a zip / tar / tar.gz archive back into files.
archive_listProList entries inside a zip / tar / tar.gz archive without extracting.
file_copyProCopy a file or a directory tree to a new path, creating missing parent directories.
file_createProCreate a new file with optional initial content.
file_create_directoryProCreate a directory, creating missing parent directories as needed.
file_deleteProPermanently delete a single file from the filesystem.
file_delete_directoryProDelete a directory.
file_editProReplace an exact, unique span of text in an existing file — the surgical alternative to rewriting the whole file with file_write.
file_list_directoryProList a directory under `entries` (name, path, type, size, mtime epoch-seconds, is_symlink, kind UTI).
file_moveProMove or rename a file or directory.
file_pick_directoryProOpen a native macOS file/folder picker dialog and return the selected path with isDirectory flag.
file_readProRead the contents of a text file as a UTF-8 string.
file_writeProWrite content to a file, creating parent directories if needed.
git_checkoutProSwitch to a branch, tag, or commit hash.
git_commitProCreate a git commit with the currently staged changes.
git_diffProShow file diffs in a git repository.
git_logProShow recent commit history for a git repository.
git_pushProPush commits to a remote repository.
git_statusProShow the working tree status of a git repository.
system_run_commandProExecute a shell command and stream stdout/stderr in real time.
workspace_addProGrant the agent access to a directory this session by pinning it to the workspace access list.

Capture

6

Screenshots, camera capture, audio recording

audio_recordProRecord audio — capture N seconds of audio to a WAV file.
vision_color_pickProEyedropper color picker — pick a color from anywhere on screen and get its hex code.
vision_recordStudioRecord the screen to a video clip — a screen recording, screencast, or capture of what is happening on a display or in a region of it, through VisionPiper — for a fixed number of seconds, or until stopped (duration_seconds=0, then command=stop).
vision_region_getProRead the on-screen capture region VisionPiper has set: its rectangle in points relative to its display (top-left origin), the display_id, the generation counter that moves on every change, whether the border indicator is showing, and whether a screen recording is running right now.
vision_region_setProSet the on-screen capture region: the one rectangle VisionPiper draws a border around and that vision_record records and vision_screenshot mode=region can capture.
vision_screenshotProTake a screenshot — capture the screen as a PNG image.

Testing

6

PiperTest CRUD and execution

test_deleteMaxDelete a saved PiperTest by ID.
test_exportMaxExport a PiperTest to Playwright or Cypress code.
test_getMaxGet a full PiperTest by ID with all steps, AX paths, element metadata, and execution context.
test_listMaxList saved PiperTests with metadata (id, name, step count, last run status).
test_runMaxExecute a PiperTest via CDP at native speed (~10-50ms/step).
test_saveMaxCreate or update a grouped PiperTest.

Motion

5

Pose estimation, real-time skeleton streaming

pose_detectStudioDetect human body poses in an image.
pose_format_listStudioList available pose detection backends, renderers, and output formats.
pose_stream_startStudioStart the real-time pose streaming WebSocket server (on-demand) and return connection details.
vision_stream_startProProcess a live WebSocket video feed with vision processors (pose, OCR, classify, upscale, faces, barcodes).
vision_stream_stopProStop a running stream processing session.

Outreach

18

GitHub, Search Console, HN, Reddit, content queue

github_activityProFetch recent activity for a GitHub repo: commits, releases, merged PRs, star/fork counts.
github_compareProCompare two Git refs (branches, tags, or SHAs) in a GitHub repo.
github_repo_listProList GitHub repositories accessible by the configured PAT (up to 100, sorted by last push).
gsc_analyticsQuery Google Search Console search analytics: clicks, impressions, CTR, position.
gsc_inspectInspect URLs in Google Search Console: indexed?, canonical URL, last crawl date, mobile usability, rich results.
gsc_site_listList all Google Search Console properties the account has access to.
gsc_sitemap_listList sitemaps for a GSC property with error/warning counts, last downloaded date, and indexed URL count.
outreach_project_getProRead one Outreach Project by id, including its full context record and dated research log.
outreach_project_listProList the Outreach Projects on this machine: the websites and apps being marketed.
outreach_project_updateProPatch an Outreach Project.
queue_addProAdd content as a draft to the outreach queue.
queue_listProList drafts in the outreach content queue.
queue_publishProMark a queued draft as published.
reddit_postProSubmit a new post or reply on Reddit.

Sieve

4

MediaPiper sieve inspection, testing, healing

sieve_healMaxDiscover or repair full-size image URL patterns for a domain's thumbnails using a local LLM.
sieve_inspectMaxGet full sieve detail for a specific domain: rule definition, canary URL pairs, mutation ops, confidence history, and health state.
sieve_listMaxList all cached image discovery sieves from the MediaPiper browser extension.
sieve_testMaxDry-run: apply the cached sieve for a domain to a specific URL.

System

181

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

autopilot_history_queryProRetrieve prior-iteration history (summaries, decisions, dead-ends, full diffs) for YOUR Autopilot loop's cold store.
autopilot_resumeProAnswer a parked escalation and resume a paused Autopilot loop.
autopilot_startProKick 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_statusProReport the current progress, run status, criteria gap, and any parked escalation for an Autopilot loop.
autopilot_stopProCancel a running (or parked) Autopilot loop and mark it terminal (STOPPED).
job_cancelCancels a still-running (or pending) async job by id: flips it to `cancelled` and stops the underlying work.
job_resultReturns the result of a COMPLETED async job: the `outputAssetId` of the Asset it produced (plus the resolved Asset record with its provenance).
job_statusReturns the current state of an async job by id: `pending`, `running` (with a progress percent), `completed`, `failed`, or `cancelled`.
schedule_createMaxArm 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_deleteMaxRemove a schedule permanently.
schedule_getMaxFetch one schedule by id, including its recent run history (outcome, detail, and coalesced missed-fire count per fire).
schedule_listMaxList every stored schedule with its trigger, action, enabled state, next fire instant, and last-run outcome.
schedule_run_nowMaxFire a schedule's action immediately, bypassing the trigger (manual trigger and test path).
schedule_updateMaxEdit a schedule's name, enabled state, trigger, or action.
system_accessibility_contrast_setEnable or disable Increase Contrast.
system_accessibility_reduce_motion_setEnable or disable Reduce Motion.
system_accessibility_stateRead current macOS accessibility state: VoiceOver, zoom, reduce motion, increase contrast.
system_accessibility_voiceover_setEnable or disable VoiceOver.
system_accessibility_zoom_setEnable or disable screen Zoom.
system_app_assert_attributeAssert a named AX attribute (e.g. AXValue, AXTitle) on a native macOS app element equals expected.
system_app_assert_countAssert the count of matching native macOS app elements equals expected.
system_app_assert_enabledAssert a native macOS app element is enabled (not greyed-out).
system_app_assert_focusedAssert a native macOS app element has keyboard focus.
system_app_assert_hiddenAssert a native macOS app element is hidden or absent.
system_app_assert_textAssert a native macOS app element's text equals the expected value.
system_app_assert_visibleAssert a native macOS app element is visible.
system_app_circuit_resetReset the per-session on-device grounding circuit breaker.
system_app_clickProClick a native macOS app element.
system_app_confirmProPress the default/confirm button in a dialog or sheet of a native macOS app.
system_app_fillProFill a text field in a native macOS app.
system_app_listList all running macOS applications with bundle IDs, names, PIDs, and active/hidden state.
system_app_pressProPress a control in a native macOS app (button, checkbox, segmented control).
system_app_resolveLocate a native macOS app element by natural-language description when no selector will address it — an icon-only button, a custom-drawn control, a canvas label.
system_app_scrollProScroll a native macOS app to bring an off-screen element into view.
system_app_set_valueProSet the value of a slider, stepper, or other AXValue-bearing element in a native macOS app.
system_app_show_menuProOpen the context menu or popup menu on a native macOS app element.
system_app_snapshotGet the accessibility tree of a running native macOS app — the native analogue of browser_snapshot.
system_appearance_accent_setSet the system accent color.
system_appearance_highlight_setSet the system highlight color (used for selected text).
system_appearance_reduce_transparency_setEnable or disable Reduce Transparency.
system_appearance_sidebar_size_setSet Finder/Mail sidebar icon size.
system_appearance_stateRead current macOS appearance state: accent color, highlight color, transparency, sidebar size.
system_audio_device_listList all available audio output devices on this Mac.
system_audio_output_setSwitch the active audio output device by name or ID.
system_audio_stateRead current audio state: volume level, mute status, current output device.
system_batchProExecute multiple actions in a single call.
system_bluetooth_connectConnect to a paired Bluetooth device by MAC address.
system_bluetooth_device_listList paired Bluetooth devices with names, MAC addresses, and connection state.
system_bluetooth_disconnectDisconnect a connected Bluetooth device by MAC address.
system_bluetooth_setTurn Bluetooth on or off.
system_bluetooth_stateRead Bluetooth state: power on/off, paired device count.
system_calendar_event_createCreate a calendar event.
system_calendar_event_deleteDelete a calendar event by ID.
system_calendar_event_listList calendar events in a date range.
system_calendar_event_updateUpdate a calendar event by ID.
system_calendar_listList all macOS calendars.
system_clipboard_clearProClear the persistent clipboard history (pinned items survive).
system_clipboard_deleteProDelete a clipboard item by ID.
system_clipboard_getProGet a single clipboard item by ID.
system_clipboard_historyProBrowse the persistent clipboard history.
system_clipboard_pinProPin a clipboard item so it survives clears.
system_clipboard_readProRead the current clipboard contents (most recent item).
system_clipboard_restoreProRestore a clipboard item to the active clipboard.
system_clipboard_unpinProUnpin a pinned clipboard item.
system_clipboard_writeProWrite text, an image, or file paths to the clipboard.
system_contact_createCreate a new contact.
system_contact_getGet a contact by ID.
system_contact_updateUpdate an existing contact by ID.
system_default_handler_getGet the default app handler for a UTI type or URL scheme.
system_default_handler_setSet the default app handler for a UTI type or URL scheme.
system_defaults_readRead a macOS UserDefaults key.
system_defaults_writeProWrite a macOS UserDefaults key.
system_desktop_hot_cornersRead or set hot corner actions.
system_desktop_screensaver_startStart the macOS screen saver immediately.
system_desktop_stage_manager_setEnable or disable Stage Manager.
system_desktop_wallpaper_getRead the current desktop wallpaper path for one display.
system_desktop_wallpaper_setSet the desktop wallpaper from an image file, on one display.
system_display_arrangeSet a display's origin in the desktop arrangement, in global points: the main display is at (0, 0), y down, and system_display_list reports every display's current origin in the same space.
system_display_brightness_setSet brightness on any display that takes it: the built-in panel, and external monitors that speak DDC/CI.
system_display_dark_mode_setTurn dark mode on or off.
system_display_listList every online display, left to right: display_id, name as System Settings shows it, size in points and pixels with scale, refresh rate, origin in global points, physical size, brightness where adjustable, and main / built-in / mirroring / placement flags (left of main, right of main, ...).
system_display_mirror_setEnable or disable display mirroring.
system_display_mode_listList a display's supported modes grouped by resolution with their refresh rates, current mode marked.
system_display_night_shift_setTurn Night Shift on or off.
system_display_resolution_setSet the display resolution.
system_display_rotateRotate a display to 0, 90, 180, or 270 degrees.
system_display_stateRead display state: dark mode, Night Shift, True Tone, mirroring, brightness where a display exposes it, and a `displays` array with every online display's id, name, size in points and pixels, position, refresh rate and placement relative to the main display.
system_display_true_tone_setTurn True Tone on or off.
system_dock_app_addAdd an app to the Dock by bundle ID.
system_dock_app_removeRemove an app from the Dock by bundle ID.
system_dock_autohide_setEnable or disable Dock auto-hide.
system_dock_magnification_setEnable or disable Dock magnification and set its size.
system_dock_position_setSet Dock screen position.
system_dock_size_setSet Dock tile size in pixels.
system_dock_stateRead current Dock state: position, tile size, auto-hide, magnification.
system_finder_infoProGet structured file metadata (path, name, type, size, mtime, kind/UTI, permissions, owner, tags) as JSON for a file or folder.
system_finder_openOpen a file or folder, optionally with a specific app.
system_finder_revealReveal a file or folder in Finder (selects the item in its containing folder).
system_finder_tagsRead or set Finder tags on a file.
system_finder_trashMove a file or folder to the Trash (recoverable).
system_finder_trash_emptyPermanently delete all items currently in the Trash.
system_focus_profile_listList configured macOS Focus profiles.
system_focus_setEnable or disable Focus / Do Not Disturb.
system_focus_stateRead current Focus / Do Not Disturb state.
system_infoGet system info: hardware, OS version, CPU, memory.
system_input_clickProSimulate a mouse click at screen coordinates.
system_input_dragProSimulate a mouse drag from (fromX, fromY) to (toX, toY).
system_input_keyProSimulate a key press with optional modifiers.
system_input_moveProMove the mouse cursor to screen coordinates.
system_input_scrollProPost a raw wheel event at a screen point.
system_input_typeProSimulate typing text character-by-character.
system_location_currentGet current GPS location.
system_location_statusCheck location services status.
system_lockLock the screen.
system_logoutLog out the current user.
system_media_nextSkip to the next track on the currently playing media app.
system_media_now_playingRead current media now-playing info (title, artist, album, position) across all macOS playback apps (Music, Spotify, YouTube, etc.).
system_media_play_pauseToggle play/pause on the currently playing media app.
system_media_prevSkip to the previous track on the currently playing media app.
system_mute_setMute or unmute audio output.
system_network_dnsRead the currently configured DNS servers.
system_network_interface_listList all network interfaces with names, types, IP addresses, and status.
system_network_joinJoin a Wi-Fi network by SSID.
system_network_pingCheck connectivity to a hostname or IP address.
system_network_scanScan for visible Wi-Fi networks and return their SSIDs and signal strength.
system_network_ssidRead the SSID of the currently joined Wi-Fi network.
system_network_stateRead overall network state: Wi-Fi on/off, current SSID, IP, connectivity.
system_network_wifi_setTurn Wi-Fi on or off.
system_notification_clearClear all delivered notifications from Notification Center.
system_notification_postPost a local macOS notification immediately.
system_notification_scheduleSchedule a local macOS notification to fire after a delay.
system_observeGet a composite snapshot of the entire Mac state in one call.
system_power_prevent_display_sleepPrevent the display from sleeping while the Mac stays awake.
system_power_prevent_sleepPrevent the Mac from sleeping (caffeinate).
system_power_stateRead battery level, charging status, and thermal state.
system_process_frontmostGet the currently-frontmost app.
system_process_infoGet info about a specific process by PID or bundle id.
system_process_killProTerminate a process by PID.
system_process_launchProLaunch a macOS app by bundle id or display name.
system_process_listList running processes / apps.
system_reminder_completeMark a reminder complete or uncomplete.
system_reminder_createCreate a reminder.
system_reminder_deleteDelete a reminder by ID.
system_reminder_listList reminders, optionally filtered by list.
system_reminder_list_listList all macOS reminder lists.
system_restartRestart the Mac.
system_settings_openOpen System Settings, optionally to a specific pane.
system_shortcut_listList all installed macOS Shortcuts.
system_shortcut_runRun a macOS Shortcut by name.
system_shutdownShut down the Mac.
system_sleepPut the Mac to sleep.
system_spaces_deleteProDelete a Mission Control space by ID.
system_spaces_listProList all Mission Control spaces/desktops with IDs and indices.
system_spaces_switchProSwitch to a Mission Control space by 1-based index.
system_spaces_window_moveProMove a window to a different Mission Control space.
system_storage_ejectEject a removable volume by mount point.
system_storage_usageCheck disk usage for a filesystem path.
system_storage_volume_listList mounted volumes (internal disks, external drives, network shares).
system_timer_cancelCancel a specific running timer by ID.
system_timer_clearCancel all running timers.
system_timer_listList all currently-running timers with remaining time.
system_timer_startStart a countdown timer that fires a macOS notification when it elapses.
system_undoProUndo the most recent reversible action: restore a trashed file, revert a defaults write, or restore prior Finder tags / default app handler.
system_undo_listList the captured inverse operations available to undo, newest first.
system_uptimeGet system uptime since last boot.
system_url_openOpen a URL in the user's default browser or app.
system_volume_setSet the system output volume.
system_window_closeClose a window.
system_window_focusBring a window to the foreground and focus it.
system_window_fullscreen_setEnter or exit fullscreen for a window.
system_window_layoutProApply a multi-window layout preset (side_by_side, stack) across the visible windows.
system_window_listList visible windows on macOS, optionally filtered by bundleId, pid, or title substring.
system_window_minimize_setMinimize or restore a window.
system_window_moveMove a window to absolute screen coordinates (x, y) in pixels.
system_window_resizeResize a window to width × height in pixels.
system_window_snapProSnap 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_completeMark a task as completed.
task_createCreate a task to track a unit of work.
task_updateUpdate the status of an existing task.

Video

63

Automated video creation pipeline

image_to_videoStudioStudio video transform (image-to-video) — the kernel's headline 'animate this image' verb.
media_project_add_adjustment_layerStudioAdds 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_facetStudioAttaches an empty facet for a medium to a `media-project` (a project holds at most one facet per medium).
media_project_add_layerStudioAdds a raster layer to the TOP of a `media-project`'s `image` facet layer stack from an existing `image` Asset.
media_project_add_sourceStudioAdds a source file to a `media-project`'s ordered source pool — the project's inputs, shared by every facet.
media_project_createStudioUnified media working document.
media_project_crop_canvasStudioPhotoshop's Crop on a `media-project`'s `image` facet: reframes the document to a rectangle of its current box, given in document pixels ('x', 'y' from the top-left, 'width', 'height'; the rectangle must lie inside the document).
media_project_deleteStudioPermanently deletes a `media-project` container Asset by id and reclaims the bytes it owns.
media_project_delete_layerStudioRemoves a layer (by its `lyr_...` id) from a `media-project`'s `image` facet.
media_project_flattenStudioComposites 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_getStudioReturns the current state of a `media-project` by id: its display name, timestamps, the facets it holds (each facet's medium), 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), and `history: { undo, redo }` — how many edits media_project_undo / media_project_redo can walk.
media_project_merge_downStudioMerges 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_redoStudioRe-applies edit(s) previously undone with media_project_undo on a `media-project`'s image document.
media_project_remove_sourceStudioRemoves a source (by its `src_...` id) from a `media-project`'s pool, along with any sources nested beneath it.
media_project_renameStudioSets a `media-project`'s display name.
media_project_reorder_layersStudioReorders 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_sourceStudioReorders 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_resampleStudioPhotoshop's Image Size on a `media-project`'s `image` facet: scales the WHOLE document to new pixel dimensions.
media_project_set_canvasStudioPhotoshop's Canvas Size on a `media-project`'s `image` facet: gives the document its own pixel box and ground WITHOUT scaling any content.
media_project_set_layerStudioUpdates a layer in a `media-project`'s `image` facet — its blend mode, opacity, visibility, and name, and its CONTENT.
media_project_set_layer_maskStudioSets or clears a layer's matte in a `media-project`'s `image` facet.
media_project_set_layer_transformStudioUpdates a RASTER layer's 2D placement — translation (pixels, top-left origin), scale along the layer's own axes, rotation (degrees clockwise) and the pivot (the reference point, in layer-native pixels from the layer's top-left) — in a `media-project`'s `image` facet.
media_project_undoStudioUndoes the last edit(s) to a `media-project`'s image document — whoever made them (this agent, another agent, the Studio canvas, a voice session).
storyboard_add_shotStudioStudio video transform.
storyboard_assembleStudioStudio video transform.
storyboard_createStudioStudio video intent layer.
storyboard_generateStudioStudio video transform.
storyboard_getStudioReturns 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_shotStudioStudio video transform.
storyboard_reorderStudioStudio video transform.
storyboard_set_shotStudioStudio video transform.
storyboard_updateStudioStudio video transform.
text_to_videoStudioStudio video transform.
video_add_clipStudioStudio video timeline transform.
video_clipsStudioBrowse the PiperClips library (~/Documents/PiperClips/).
video_deleteStudioDelete a video screenplay and all associated artifacts (storyboards, recordings, narration).
video_edit_compositionStudioEdit visual/production settings for a screenplay.
video_edit_narrationStudioEdit narration and audio settings for a screenplay.
video_edit_screenplayStudioEdit a screenplay's scenes and steps.
video_edit_timelineStudioEdit the post-recording timeline for a screenplay.
video_exportStudioExports 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_timelineStudioExport a screenplay's edit timeline to an interchange format for use in external NLEs (Final Cut Pro, Premiere, DaVinci Resolve).
video_getStudioGet a full video screenplay by ID with all scenes, steps, video config, narration config, and stage results.
video_import_mediaStudioImport an external video file (screen recording, stock footage, camera footage) into a screenplay's media library.
video_inspectStudioRenders 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_listStudioList video screenplays with metadata (id, name, stage, scene count, source ref).
video_move_clipStudioStudio video timeline transform.
video_narrateStudioGenerate TTS narration audio for a screenplay's scenes.
video_previewStudioPreview a recorded screenplay.
video_recordStudioRecord a video by executing a screenplay — drives Chrome via CDP with human-like pacing while VisionPiper captures the screen.
video_rehearseStudioDry-run a screenplay via CDP.
video_remove_clipStudioStudio video timeline transform.
video_renderStudioPost-process a recorded screenplay: composite with frame styling, zoom, cursor overlays, color grade.
video_reorderStudioStudio video timeline transform.
video_saveStudioCreate or update a video screenplay.
video_segmentStudioStudio video transform — the region authority's video door.
video_set_clipStudioStudio video timeline transform.
video_set_keyframesStudioStudio video timeline transform.
video_set_render_rangeStudioStudio video timeline transform.
video_settingsStudioGet or update default video settings (preset, voice, language, pacing, capture, branding, subtitles, sound design).
video_splitStudioStudio video timeline transform.
video_timelineStudioReturns 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_trimStudioStudio video timeline transform.

Video Tools

7

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

media_extractStudioDiscover 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_hostStudioHost 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_saveProSave 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_capabilitiesStudioList 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_clipStudioTrim 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_fileStudioSave an already-hosted video artifact to a real file in a user output folder — the save-to-disk / download step.
video_upscaleStudioUpscale a video file 2x using PiperSR on Apple Neural Engine.

OAuth

4

OAuth connection management

oauth_connectStart an OAuth browser consent flow for a provider (Google, Reddit, GitHub, X).
oauth_connect_service_accountConnect a Google service account using a JSON key file.
oauth_disconnectDisconnect an OAuth provider.
oauth_statusCheck 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.