# Amara — MCP server on mcp.ai
> Connect your Amara account and use 30 tools for video and audio straight from your AI agent. Connect with your own API key. Amara is an online platform that enables users to create, edit, and manage subtitles and captions for videos, facilitating accessibility and multilingual content.

By: mcp.ai · official
Page: https://mcp.ai/amara

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_amara?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/amara/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/amara/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/amara/skill.md
Postman collection (v2.1): https://mcp.ai/amara/postman.json

## Tools
- amara_add_subtitle_note(body: string, video_id: string, language_code: string) — Adds a note/comment to a specific subtitle language for a video. Notes are used for collaboration and providing feedback on subtitles during the editing process. Requires a valid video ID and language
- amara_add_video_url(url: string, primary?: boolean, video_id: string) — Tool to add a new URL to a video, allowing association with multiple video providers (YouTube, Vimeo, etc.). Use when you need to add alternative URLs for the same video content on different platforms
- amara_create_subtitle_language(language: string, video_id: string) — Creates a new subtitle language track for an Amara video. This is the first step before adding or uploading subtitles - you must create the language track before you can add subtitle content. Each vid
- amara_create_subtitles(title?: string, action?: string, metadata?: object, video_id: string, subtitles?: string, sub_format: string, description?: string, language_code: string, subtitles_url?: string) — Tool to create new subtitles for a video in a specific language. Accepts subtitle data in multiple formats (SRT, VTT, DFXP, etc.) either as a string or via URL. The subtitle language must already exis
- amara_create_video(team?: string, title: string, project?: string, duration?: integer, metadata?: object, thumbnail?: string, video_url: string, description?: string, primary_audio_language_code?: string) — Tool to add a new video to Amara. Use when you need to create a video entry from a URL. Supports URLs from YouTube, Vimeo, Dailymotion, or direct video file URLs.
- amara_delete_video_url(url_id: integer, video_id: string) — Tool to remove a video URL from a video. Use when you need to delete an unwanted or incorrect URL from a video's list of URLs. The video must have at least one other URL remaining.
- amara_fetch_subtitles_data(format?: string, video_id: string, language_code: string) — Fetch subtitle data for a video in a specific language. Returns a list of subtitle segments with start/end timestamps and text content. Use this after obtaining a video ID (from List Videos) and confi
- amara_get_activity(activity_id: integer) — Tool to retrieve detailed information about a specific activity by its ID. Use when you need to fetch metadata for a particular activity event.
- amara_get_subtitle_language_details(video_id: string, language_code: string) — Tool to retrieve details for a single subtitle language. Use when you have video ID and language code and need metadata about that language track.
- amara_get_team_details(slug: string) — Tool to get details on a specific team by slug. Use when you need metadata for a single team.
- amara_get_team_languages(slug: string) — Tool to get language preferences for a specific team by slug. Use when you need to retrieve preferred and blacklisted languages for a team.
- amara_get_user_activity(limit?: integer, offset?: integer, identifier: string) — Tool to retrieve activity log for a specific user on Amara. Use when you need to view a user's recent actions such as video additions, subtitle edits, or comments. Returns a paginated list of activity
- amara_get_user_data(identifier: string) — Retrieves detailed user profile information from Amara, including username, avatar, biography, languages spoken, and video counts. Use this tool when you need to: - Fetch a user's profile details by t
- amara_get_video_url(url_id: integer, video_id: string) — Tool to get details for a specific video URL. Use when you need to retrieve metadata about a specific URL entry in Amara's system by video_id and url_id.
- amara_get_video_url_details(url: string) — Tool to get details for a specific video URL. Use when you have a public or embeddable video URL and need its Amara metadata (ID, title, duration, thumbnails, etc.).
- amara_list_activity(team?: string, type?: integer, after?: string, limit?: integer, video?: string, before?: string, offset?: integer, language?: string, team_activity?: boolean) — Tool to list activity across Amara. Use when you need to retrieve activity logs with optional filters by team, video, or activity type.
- amara_list_available_languages() — Tool to get a list of all supported languages. Use when you need to know available language options from Amara.
- amara_list_subtitle_actions(video_id: string, language_code: string) — Tool to list available actions for subtitles based on current workflow state. Use when you need to determine what operations can be performed on a subtitle (e.g., approve, reject, publish) for a speci
- amara_list_subtitle_languages(video_id: string) — Tool to list all subtitle languages for a video. Use when you have a video ID and need to fetch its available subtitle languages.
- amara_list_subtitle_notes(limit?: integer, offset?: integer, video_id: string, language_code: string) — List notes for subtitles in a specific language. Use this to retrieve all notes/comments added to a subtitle language for collaboration and feedback purposes.
- amara_list_teams(limit?: integer, offset?: integer) — Tool to list all teams. Use when you need to retrieve your accessible teams with pagination.
- amara_list_video_activity(limit?: integer, offset?: integer, video_id: string) — Tool to list activity for a specific video. Use when you need to fetch the activity log or history of actions performed on a video.
- amara_list_video_urls(limit?: integer, offset?: integer, video_id: string) — Tool to list all URLs associated with a video. Use when you need to retrieve every URL for embedding or processing.
- amara_list_videos(sort?: string, team?: string, limit?: integer, owner?: string, offset?: integer, archive?: boolean, project?: string, language?: string, video_id?: string, video_url?: string) — Tool to list all videos. Use when you need to fetch a paginated list of videos with optional filters.
- amara_make_video_url_primary(url_id: integer, primary: boolean, video_id: string) — Tool to set a video URL as the primary URL. Use when you need to designate one of a video's URLs as primary for embedding and display. Call after listing video URLs to confirm the URL ID.
- amara_perform_subtitle_action(action: string, video_id: string, language_code: string) — Tool to perform an action on subtitles such as publish, unpublish, approve, reject, send-back, or endorse. Use when you need to change the workflow state of subtitles for a specific video and language
- amara_send_message(team?: string, user?: string, content: string, subject: string) — Sends a message to a user or team member in Amara. Use this tool to send notifications, updates, or communicate with other users or teams on the platform. You must specify either a recipient user (by 
- amara_update_subtitle_language(video_id: string, language_code: string, soft_limit_cpl?: integer, soft_limit_cps?: integer, soft_limit_lines?: integer, subtitles_complete?: boolean, soft_limit_max_duration?: integer, soft_limit_min_duration?: integer, is_primary_audio_language?: boolean) — Tool to update a subtitle language for a video. Use after reviewing existing subtitle language settings and needing to adjust completeness flags or soft-limit constraints.
- amara_update_video(team?: string, title?: string, project?: string, duration?: integer, metadata?: object, video_id: string, thumbnail?: string, description?: string, primary_audio_language_code?: string) — Tool to update an existing video's metadata including title, description, team, and project assignment. Use when you need to modify video information after creation.
- amara_view_video_details(video_id: string) — Tool to view details of a specific video by ID. Use when you need complete metadata for a given video.

## Example prompts
- "What can I do in Amara?"
- "Show me a summary of my Amara account"

## Links
Docs: https://mcp.ai/docs/mcps/amara
Website: https://mcp.ai/mcps/amara