ToolPiper MCP Server
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.
422 of 422 tools
LLM inference, voice chat, TTS, STT, models, embeddings, OCR
audio_speakConvert text to speech and save as a WAV file.audio_transcribeTranscribe an audio file (WAV, MP3, M4A, FLAC) to text using on-device speech recognition.audio_voice_cloneGenerate speech using a cloned voice from a reference audio sample.chatRun a prompt through a local LLM on this machine via ToolPiper.claude_code_installMaxInstall 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_uninstallMaxReverse 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_searchFind a model, LoRA, VAE, or embedding by free-text query across a source.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 using a local embedding model or Apple's built-in NL embeddings (zero-setup, 512-dim).text_translateTranslate text between languages using Apple's on-device Translation framework.tool_docsGet the full description and typed input schema for named tools.tool_searchFind the right tools for a task by describing what you want to do in natural language.vision_camera_captureCapture a single still frame from the Mac's webcam and return it as a base64-encoded PNG (≤1280 px on the longest edge).vision_ocrExtract 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.Image/text analysis, RAG, PDF extraction, upscaling
asset_deletePermanently delete an Asset record by id and reclaim the artifact bytes it solely owns.asset_describeChat-to-feature reference transform.image_adjustStudio image edit.image_analyzeAnalyze an image using Apple Vision.image_black_and_whiteStudio image edit.image_blend_maskedStudio transform — apply ANY image edit to just one REGION of an image.image_conditioningStudio transform — structural-conditioning producer.image_cropStudio image edit.image_curvesStudio image edit.image_cutoutStudio transform.image_editStudio transform (image-to-image), REGION-SCOPABLE.image_erase_regionStudio transform — GENERATIVE ERASE.image_fillStudio image edit.image_filterStudio image edit.image_flipStudio image edit.image_free_transformStudio image edit.image_generateStudio transform.image_gradientStudio image edit.image_gradient_mapStudio image edit.image_grayscaleStudio image edit.image_importStudio ingress (Apple typed-media rich import).image_inpaintStudio transform — GENERATIVE FILL of one region.image_invertStudio image edit.image_levelsStudio image edit.image_mask_refineStudio selection edit.image_outpaintStudio transform — CANVAS EXTEND.image_perspectiveStudio image edit.image_posterizeStudio image edit.image_remove_subjectStudio transform.image_resizeStudio image edit.image_rotateStudio image edit.image_segmentStudio transform — the region authority.image_straightenStudio image edit.image_textStudio image edit.image_thresholdStudio image edit.image_to_splatStudio transform.image_to_worldStudio transform.image_transformTransform 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_benchmarkMeasure PiperSR upscale performance on this machine.image_upscale_neuralStudio transform — GENERATIVE detail upscale.pdf_extractExtract text, per-page text, images, or metadata from a PDF file.qr_generateGenerate 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_importStudio ingress (byte-to-typed-Asset video import).AX-native browser automation, scraping, assertions
browser_actionPerform 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_assertAssert a condition on the current browser page.browser_autofillTrigger Chrome's autofill on form fields.browser_consoleGet browser console messages (log, warn, error) and optionally network request logs.browser_coverageMeasure JavaScript and CSS code coverage.browser_detectDetect the frontend framework, meta-framework, CMS, state libraries, router, and dev/prod mode on the current page.browser_dialog_handleResolve the pending JavaScript dialog.browser_disconnectDisconnect the CDP debugger from Chrome.browser_emulateEmulate device and environment conditions on the active Chrome tab.browser_evalExecute JavaScript in the browser page and return the result.browser_interceptIntercept and mock network requests.browser_launchLaunch Chrome with remote debugging pre-enabled — avoids the 'Allow remote debugging?' dialog.browser_locatorGiven an element on the current page, return the canonical, ranked set of stable accessibility selectors to use in saved tests.browser_networkInspect network traffic in the browser with full request/response detail.browser_page_closeClose 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_newOpen a new Chrome tab, optionally navigating to a URL.browser_page_selectSwitch the active Chrome tab the other browser_* tools operate on.browser_pdfRender the current browser page to a PDF file and return its path as a resource link.browser_performanceMeasure and audit browser performance.browser_recordRecord 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_statusRead 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_storageRead and write browser storage: cookies, localStorage, sessionStorage.browser_viewport_resizeSet the viewport width and height for the active Chrome tab.browser_webauthnTest WebAuthn/passkey flows with a virtual authenticator.browser_webmcpDiscover and invoke WebMCP tools that the current page exposes.http_requestMake a raw HTTP request to any URL — returns the HTTP status code, response headers, and raw response body (JSON, text, or bytes).http_request_replayMaxReplay a discovered API endpoint with optional parameter overrides.web_api_discoverMaxPassively 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.File operations, archives, Git, workspace search
archive_createBundle files and folders into a zip / tar / tar.gz archive.archive_extractUnpack a zip / tar / tar.gz archive back into files.archive_listList entries inside a zip / tar / tar.gz archive without extracting.code_searchgrep INSIDE source files.file_copyCopy a file or a directory tree to a new path, creating missing parent directories.file_createCreate a new file with optional initial content.file_create_directoryCreate a directory, creating missing parent directories as needed.file_deletePermanently delete a single file from the filesystem.file_delete_directoryDelete a directory.file_editReplace an exact, unique span of text in an existing file — the surgical alternative to rewriting the whole file with file_write.file_list_directoryList a directory under `entries` (name, path, type, size, mtime epoch-seconds, is_symlink, kind UTI).file_moveMove or rename a file or directory.file_pick_directoryOpen a native macOS file/folder picker dialog and return the selected path with isDirectory flag.file_readRead the contents of a text file as a UTF-8 string.file_writeWrite content to a file, creating parent directories if needed.git_checkoutSwitch to a branch, tag, or commit hash.git_commitCreate a git commit with the currently staged changes.git_diffShow file diffs in a git repository.git_logShow recent commit history for a git repository.git_pushPush commits to a remote repository.git_statusShow the working tree status of a git repository.system_run_commandExecute a shell command and stream stdout/stderr in real time.workspace_addGrant the agent access to a directory this session by pinning it to the workspace access list.workspace_searchFind files and folders by filename or path prefix.Screenshots, camera capture, audio recording
audio_recordRecord audio — capture N seconds of audio to a WAV file.vision_color_pickEyedropper color picker — pick a color from anywhere on screen and get its hex code.vision_screenshotTake a screenshot — capture the screen as a PNG image.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.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_startProcess a live WebSocket video feed with vision processors (pose, OCR, classify, upscale, faces, barcodes).vision_stream_stopStop a running stream processing session.GitHub, Search Console, HN, Reddit, content queue
github_activityStudioFetch recent activity for a GitHub repo: commits, releases, merged PRs, star/fork counts.github_compareStudioCompare two Git refs (branches, tags, or SHAs) in a GitHub repo.github_repo_listStudioList GitHub repositories accessible by the configured PAT (up to 100, sorted by last push).gsc_analyticsStudioQuery Google Search Console search analytics: clicks, impressions, CTR, position.gsc_inspectStudioInspect URLs in Google Search Console: indexed?, canonical URL, last crawl date, mobile usability, rich results.gsc_site_listStudioList all Google Search Console properties the account has access to.gsc_sitemap_listStudioList sitemaps for a GSC property with error/warning counts, last downloaded date, and indexed URL count.hn_searchStudioSearch Hacker News stories and comments via Algolia.hn_trending_listStudioGet trending stories from Hacker News right now.queue_addStudioAdd content as a draft to the outreach queue.queue_listStudioList drafts in the outreach content queue.queue_publishStudioMark a queued draft as published.reddit_postStudioSubmit a new post or reply on Reddit.reddit_searchStudioSearch Reddit posts by keyword, optionally scoped to a subreddit.web_searchGeneral-purpose open-web search.SERP search, autocomplete, SEO rank tracking
serp_autocompleteKeyword discovery via Google Suggest — returns the real autocomplete queries people search for a seed term.serp_rank_checkFind where specific domains rank in the live Google or Bing results for a query.serp_searchCapture the live Google or Bing search-results page for a query via a real browser.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.macOS system actions — audio, display, windows, Finder, clipboard, and more
autopilot_history_queryRetrieve prior-iteration history (summaries, decisions, dead-ends, full diffs) for YOUR Autopilot loop's cold store.autopilot_resumeAnswer a parked escalation and resume a paused Autopilot loop.autopilot_startKick 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_statusReport the current progress, run status, criteria gap, and any parked escalation for an Autopilot loop.autopilot_stopCancel 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_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_resetPhase 5. reset the per-session on-device grounding circuit breaker.system_app_clickClick a native macOS app element.system_app_confirmPress the default/confirm button in a dialog or sheet of a native macOS app.system_app_fillFill 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_pressPress a control in a native macOS app (button, checkbox, segmented control).system_app_resolvePhase 5. VLM grounding resolver (third tier of the resolver hierarchy).system_app_set_valueSet the value of a slider, stepper, or other AXValue-bearing element in a native macOS app.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_batchExecute 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_clearClear the persistent clipboard history (pinned items survive).system_clipboard_deleteDelete a clipboard item by ID.system_clipboard_getGet a single clipboard item by ID.system_clipboard_historyBrowse the persistent clipboard history.system_clipboard_pinPin a clipboard item so it survives clears.system_clipboard_readRead the current clipboard contents (most recent item).system_clipboard_restoreRestore a clipboard item to the active clipboard.system_clipboard_searchFuzzy-search the persistent clipboard history (text + OCR).system_clipboard_unpinUnpin a pinned clipboard item.system_clipboard_writeWrite text, an image, or file paths to the clipboard.system_contact_createCreate a new contact.system_contact_getGet a contact by ID.system_contact_searchSearch macOS contacts by name.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_writeWrite 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.system_desktop_wallpaper_setSet the desktop wallpaper from an image file.system_display_arrangeSet the origin (x, y) for a display in the desktop arrangement.system_display_brightness_setSet the screen brightness on the main display.system_display_dark_mode_setTurn dark mode on or off.system_display_listList all attached displays with IDs, sizes, and main-display flag.system_display_mirror_setEnable or disable display mirroring.system_display_mode_listList supported resolution / refresh-rate modes for a display.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 current display state: brightness, dark mode, Night Shift, True Tone, resolution, mirroring.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_infoGet 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_clickSimulate a mouse click at screen coordinates.system_input_dragSimulate a mouse drag from (fromX, fromY) to (toX, toY).system_input_keySimulate a key press with optional modifiers.system_input_moveMove the mouse cursor to screen coordinates.system_input_scrollSimulate scroll wheel input.system_input_typeSimulate 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_killTerminate a process by PID.system_process_launchLaunch 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_deleteDelete a Mission Control space by ID.system_spaces_listList all Mission Control spaces/desktops with IDs and indices.system_spaces_switchSwitch to a Mission Control space by 1-based index.system_spaces_window_moveMove 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_undoUndo 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_layoutApply 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_snapSnap 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.Automated video creation pipeline
image_to_videoStudio video transform (image-to-video) — the kernel's headline 'animate this image' verb.media_project_add_adjustment_layerAdds 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_facetAttaches an empty facet for a medium to a `media-project` (a project holds at most one facet per medium).media_project_add_layerAdds 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_sourceAdds a REFERENCE to a source file into a `media-project`'s ordered source pool — the project's inputs, shared by every facet.media_project_createUnified media working document.media_project_deletePermanently deletes a `media-project` container Asset by id and reclaims the bytes it owns.media_project_delete_layerRemoves a layer (by its `lyr_...` id) from a `media-project`'s `image` facet.media_project_flattenComposites 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_getReturns 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_downMerges 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_sourceRemoves a source (by its `src_...` id) from a `media-project`'s pool, along with any sources nested beneath it.media_project_renameSets a `media-project`'s display name.media_project_reorder_layersReorders 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_sourceReorders 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_layerUpdates a layer in a `media-project`'s `image` facet — its blend mode, opacity, visibility, and name, and its CONTENT.media_project_set_layer_maskSets or clears a layer's matte in a `media-project`'s `image` facet.media_project_set_layer_transformUpdates 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_shotStudio video transform.storyboard_assembleStudio video transform.storyboard_createStudio video intent layer.storyboard_generateStudio video transform.storyboard_getReturns 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_shotStudio video transform.storyboard_reorderStudio video transform.storyboard_set_shotStudio video transform.storyboard_updateStudio video transform.text_to_videoStudio video transform.video_add_clipStudio 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_exportExports 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_inspectRenders 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_clipStudio 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_clipStudio video timeline transform.video_renderStudioPost-process a recorded screenplay: composite with frame styling, zoom, cursor overlays, color grade.video_reorderStudio video timeline transform.video_saveStudioCreate or update a video screenplay.video_segmentStudio video transform — the region authority's video door.video_set_clipStudio video timeline transform.video_set_keyframesStudio video timeline transform.video_set_render_rangeStudio video timeline transform.video_settingsStudioGet or update default video settings (preset, voice, language, pacing, capture, branding, subtitles, sound design).video_splitStudio video timeline transform.video_timelineReturns 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_trimStudio video timeline transform.Video Tools platform: acquire, transform, serve, and capability introspection
media_extractDiscover 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_hostHost 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_saveSave 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_capabilitiesList 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 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.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.