# PromptFy MCP connector guide

The PromptFy MCP connector lets an authorized assistant work with your scripts, creator profiles, cues, projects, and local audio/video workflows. An active PromptFy subscription is required. The assistant does not make purchases. Voice generation and dubbing are available in the PromptFy app but are not exposed by the connector reviewed for the Claude directory. Availability of individual tools can differ by assistant or deployment; consult its current tool list.

## Connect and permissions

Connect PromptFy in your assistant, sign in to PromptFy, and review the requested OAuth permissions before approving. Grant only permissions you want to use; reconnect if a tool requires a scope you did not grant. You can revoke the connection in PromptFy's account settings. Revocation does not remove information already shared with the assistant provider.

- `scripts:read` / `scripts:write`: read or change scripts and their cues.
- `profiles:read` / `profiles:write`: read or change creator profiles.
- `projects:write`: create, rename, duplicate, link, reorder, or delete projects.
- `devices:control`: find an available device, open the teleprompter, and manage browser jobs.
- `media:read`: read project, transcript, and audio clip metadata.
- `media:process`: request video editing/export or local audio processing and previews.

Requested scopes depend on the assistant and enabled tools. For a precise operation, see the consent screen and the tool descriptions in your assistant.

## Tools

- Scripts: `list_scripts`, `get_script`, `create_script`, `update_script`, `set_script_profile`, `delete_script`, `format_for_teleprompter`, `estimate_duration`.
- Profiles: `list_profiles`, `get_profile`, `create_profile`, `update_profile`, `delete_profile`.
- Cues: `list_cues`, `create_cue`, `update_cue`, `delete_cue`.
- Projects: `list_projects`, `get_project`, `create_project`, `rename_project`, `duplicate_project`, `set_project_links`, `reorder_project_clip`, `delete_project`, `get_project_transcript`.
- Devices and jobs: `list_devices`, `open_in_teleprompter`, `get_job`, `wait_for_job`, `cancel_job`.
- Video and audio: `edit_video`, `export_video`, `list_audio_clips`, `isolate_voice`, `identify_sounds`, `get_audio_mixer`, `mix_audio`, and, where enabled, `send_audio_to_chat`.
- Account: `get_account`.

Deleting content is destructive. Ask the assistant to explain what it will change, and review changes in PromptFy. `format_for_teleprompter` formats text without saving it.

## Browser and job workflow

Keep a PromptFy web tab open and signed in on the computer that has the source media. Some script and account operations can run without that tab, but local video/audio tasks and browser project actions need the right online browser. Project mutations require the source editor to be closed and the project metadata synced. If several browsers are online, select the one containing the media. Local files are not automatically copied to another browser.

A local task can return a `job_id`: use `wait_for_job` or `get_job` to check its progress and final result. A queued or running status does not mean the task succeeded. If supported, `cancel_job` requests cancellation. Outputs generally stay in PromptFy or download on the source computer. `send_audio_to_chat`, where available and explicitly requested, transfers an audio preview to the assistant; don't use it to share media you do not intend to send. Sound detections are estimates, not guaranteed isolated tracks.

## Troubleshooting

- **Sign-in or authorization failed:** Sign in to the intended PromptFy account and reconnect from the assistant; ensure the account has an active subscription. Review and grant the permissions needed for the requested tool.
- **Missing permission:** Reconnect and grant the relevant scope; existing authorizations do not automatically gain new scopes.
- **Device offline or job waiting:** Open or refresh PromptFy in the browser on the source computer, sign in to the same account, and keep the tab open until the job finishes.
- **Media or project unavailable:** Select the correct browser and project, verify the source files are present, close the source editor before project mutations, and allow synchronization to finish. Do not clear browser storage: it can contain local media.
- **An error or unexpected result:** Read the returned error and hint, inspect the job status, and contact [PromptFy support](https://www.promptfyapp.com/support) with the tool name and error code. Do not send credentials, tokens, or private media in a support request unless specifically needed and safely arranged.