# App-only MCP tools

Canonical HTML page: https://bitterclip.com/docs/assistants/app-only-tools

Product release: 8fb517eaea236a51ea46e1d5b40eef4a3e61c138
Public contract commit: 1ce47f7857ae3d9b6933fe83d5c33de3ae5efc64
Public contract SHA-256: 241d47d25e4b4c1dae9d2263793874d06fc4ba7bc3c78d4cf2bc63fbb32ed7dc
Descriptor SHA-256: 1ee166ecc1deeb292894fae702d1119dc7c318a3cc1cd25ffd20f83d09cb8ef6
Captured: 2026-09-25T07:49:27.929Z
Source: https://app.bitterclip.com/api/v1/mcp_descriptors.json

MCP hosts can list these 50 registered tools through the app profile. They are outside the [63-tool default model profile](https://bitterclip.com/docs/assistants/tool-reference). Each page shows the exact app descriptor captured from serving Rails, with errors and examples.

- [recordings_create_from_url](https://bitterclip.com/docs/assistants/tools/recordings_create_from_url) — Queue recording URL ingest
- [recordings_request_upload](https://bitterclip.com/docs/assistants/tools/recordings_request_upload) — Request a recording upload grant
- [recordings_finalize_upload](https://bitterclip.com/docs/assistants/tools/recordings_finalize_upload) — Finalize a recording upload
- [recordings_abort_upload](https://bitterclip.com/docs/assistants/tools/recordings_abort_upload) — Abort a recording upload
- [open_uploader](https://bitterclip.com/docs/assistants/tools/open_uploader) — Get a recording upload link
- [recordings_prepare_preview](https://bitterclip.com/docs/assistants/tools/recordings_prepare_preview) — Prepare a recording preview
- [recordings_retranscribe](https://bitterclip.com/docs/assistants/tools/recordings_retranscribe) — Re-transcribe & re-diarize a recording
- [recordings_update](https://bitterclip.com/docs/assistants/tools/recordings_update) — Update recording metadata
- [recordings_get_speaker_evidence](https://bitterclip.com/docs/assistants/tools/recordings_get_speaker_evidence) — Get recording speaker evidence
- [recordings_get_person_detections](https://bitterclip.com/docs/assistants/tools/recordings_get_person_detections) — Get recording person detections
- [compositions_assemble_score](https://bitterclip.com/docs/assistants/tools/compositions_assemble_score) — Assemble the composition transcript score
- [compositions_save_draft](https://bitterclip.com/docs/assistants/tools/compositions_save_draft) — Save the composition edit document
- [angle_mutate](https://bitterclip.com/docs/assistants/tools/angle_mutate) — Change a camera angle
- [compositions_get_draft](https://bitterclip.com/docs/assistants/tools/compositions_get_draft) — Load the saved composition edit document
- [speakers_search](https://bitterclip.com/docs/assistants/tools/speakers_search) — Search remembered people
- [speakers_review_read](https://bitterclip.com/docs/assistants/tools/speakers_review_read) — List speaker review queue
- [speakers_avatar_mutate](https://bitterclip.com/docs/assistants/tools/speakers_avatar_mutate) — Change a profile photo
- [speakers_track_mutate](https://bitterclip.com/docs/assistants/tools/speakers_track_mutate) — Change a recording speaker track
- [speakers_profile_mutate](https://bitterclip.com/docs/assistants/tools/speakers_profile_mutate) — Change a remembered person
- [speakers_list_avatar_candidates](https://bitterclip.com/docs/assistants/tools/speakers_list_avatar_candidates) — List profile photo choices
- [speakers_merge_preview](https://bitterclip.com/docs/assistants/tools/speakers_merge_preview) — Preview speaker merge
- [speakers_set_project_presentation](https://bitterclip.com/docs/assistants/tools/speakers_set_project_presentation) — Set project speaker name
- [moments_mutate](https://bitterclip.com/docs/assistants/tools/moments_mutate) — Change a saved moment
- [open_workspace](https://bitterclip.com/docs/assistants/tools/open_workspace) — Open BitterClip workspace
- [identity_read_account](https://bitterclip.com/docs/assistants/tools/identity_read_account) — Read account FX identity
- [identity_read_project](https://bitterclip.com/docs/assistants/tools/identity_read_project) — Read project Brand Studio identity
- [fx_template_preview](https://bitterclip.com/docs/assistants/tools/fx_template_preview) — Preview an FX template
- [identity_brand_update](https://bitterclip.com/docs/assistants/tools/identity_brand_update) — Set the account brand name
- [identity_account_defaults_update](https://bitterclip.com/docs/assistants/tools/identity_account_defaults_update) — Update account Signature defaults
- [fx_studio_read](https://bitterclip.com/docs/assistants/tools/fx_studio_read) — Read FX Studio state
- [identity_library_remove](https://bitterclip.com/docs/assistants/tools/identity_library_remove) — Remove saved Brand Studio asset
- [identity_part_promote_to_brand](https://bitterclip.com/docs/assistants/tools/identity_part_promote_to_brand) — Save identity object variant to Brand Studio
- [identity_prewarm_project](https://bitterclip.com/docs/assistants/tools/identity_prewarm_project) — Prewarm project Brand Studio identity
- [identity_music_beds_list](https://bitterclip.com/docs/assistants/tools/identity_music_beds_list) — List identity music beds
- [identity_music_beds_generate](https://bitterclip.com/docs/assistants/tools/identity_music_beds_generate) — Generate identity music bed
- [identity_music_beds_curate](https://bitterclip.com/docs/assistants/tools/identity_music_beds_curate) — Curate music library track
- [music_library_cue_handoff](https://bitterclip.com/docs/assistants/tools/music_library_cue_handoff) — Carry a music range through the library
- [transcript_words_window](https://bitterclip.com/docs/assistants/tools/transcript_words_window) — Read approximate word annotations for transcript lines
- [episode_subject_presence](https://bitterclip.com/docs/assistants/tools/episode_subject_presence) — Read who is on screen over an episode window
- [episode_audio_evidence](https://bitterclip.com/docs/assistants/tools/episode_audio_evidence) — Read editor audio evidence
- [episode_edit_full](https://bitterclip.com/docs/assistants/tools/episode_edit_full) — Edit an episode from the app editor
- [episode_render](https://bitterclip.com/docs/assistants/tools/episode_render) — Render an episode to a downloadable file
- [episode_status](https://bitterclip.com/docs/assistants/tools/episode_status) — Check an episode's render status (and get the file)
- [open_recording](https://bitterclip.com/docs/assistants/tools/open_recording) — Open a recording for editing
- [connections_status](https://bitterclip.com/docs/assistants/tools/connections_status) — Get publish connection status
- [publishing_package_create](https://bitterclip.com/docs/assistants/tools/publishing_package_create) — Prepare a reviewable publish package
- [publishing_state_read](https://bitterclip.com/docs/assistants/tools/publishing_state_read) — Read publish state
- [publishing_publish_mutate](https://bitterclip.com/docs/assistants/tools/publishing_publish_mutate) — Advance the publish workflow
- [youtube_prepare_recording_package](https://bitterclip.com/docs/assistants/tools/youtube_prepare_recording_package) — Prepare full recording for YouTube
- [publishing_get_composition_publish_state](https://bitterclip.com/docs/assistants/tools/publishing_get_composition_publish_state) — Get composition publish readiness