# Amara — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_amara?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `amara_add_subtitle_note`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/amara`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/amara/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/amara/add/subtitle/note` — 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
  - body: { body: string, video_id: string, language_code: string }
- `POST https://api.mcp.ai/api/amara/add/video/url` — 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
  - body: { url: string, primary?: boolean, video_id: string }
- `POST https://api.mcp.ai/api/amara/create/subtitle/language` — 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
  - body: { language: string, video_id: string }
- `POST https://api.mcp.ai/api/amara/create/subtitles` — 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
  - body: { title?: string, action?: string, metadata?: object, video_id: string, subtitles?: string, sub_format: string, description?: string, language_code: string, subtitles_url?: string }
- `POST https://api.mcp.ai/api/amara/create/video` — 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.
  - body: { team?: string, title: string, project?: string, duration?: integer, metadata?: object, thumbnail?: string, video_url: string, description?: string, primary_audio_language_code?: string }
- `POST https://api.mcp.ai/api/amara/delete/video/url` — 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.
  - body: { url_id: integer, video_id: string }
- `POST https://api.mcp.ai/api/amara/fetch/subtitles/data` — 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
  - body: { format?: string, video_id: string, language_code: string }
- `POST https://api.mcp.ai/api/amara/get/activity` — Tool to retrieve detailed information about a specific activity by its ID. Use when you need to fetch metadata for a particular activity event.
  - body: { activity_id: integer }
- `POST https://api.mcp.ai/api/amara/get/subtitle/language/details` — 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.
  - body: { video_id: string, language_code: string }
- `POST https://api.mcp.ai/api/amara/get/team/details` — Tool to get details on a specific team by slug. Use when you need metadata for a single team.
  - body: { slug: string }
- `POST https://api.mcp.ai/api/amara/get/team/languages` — Tool to get language preferences for a specific team by slug. Use when you need to retrieve preferred and blacklisted languages for a team.
  - body: { slug: string }
- `POST https://api.mcp.ai/api/amara/get/user/activity` — 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
  - body: { limit?: integer, offset?: integer, identifier: string }
- `POST https://api.mcp.ai/api/amara/get/user/data` — 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
  - body: { identifier: string }
- `POST https://api.mcp.ai/api/amara/get/video/url` — 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.
  - body: { url_id: integer, video_id: string }
- `POST https://api.mcp.ai/api/amara/get/video/url/details` — 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.).
  - body: { url: string }
- `POST https://api.mcp.ai/api/amara/list/activity` — Tool to list activity across Amara. Use when you need to retrieve activity logs with optional filters by team, video, or activity type.
  - body: { team?: string, type?: integer, after?: string, limit?: integer, video?: string, before?: string, offset?: integer, language?: string, team_activity?: boolean }
- `POST https://api.mcp.ai/api/amara/list/available/languages` — Tool to get a list of all supported languages. Use when you need to know available language options from Amara.
- `POST https://api.mcp.ai/api/amara/list/subtitle/actions` — 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
  - body: { video_id: string, language_code: string }
- `POST https://api.mcp.ai/api/amara/list/subtitle/languages` — Tool to list all subtitle languages for a video. Use when you have a video ID and need to fetch its available subtitle languages.
  - body: { video_id: string }
- `POST https://api.mcp.ai/api/amara/list/subtitle/notes` — 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.
  - body: { limit?: integer, offset?: integer, video_id: string, language_code: string }
- `POST https://api.mcp.ai/api/amara/list/teams` — Tool to list all teams. Use when you need to retrieve your accessible teams with pagination.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/amara/list/video/activity` — 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.
  - body: { limit?: integer, offset?: integer, video_id: string }
- `POST https://api.mcp.ai/api/amara/list/video/urls` — Tool to list all URLs associated with a video. Use when you need to retrieve every URL for embedding or processing.
  - body: { limit?: integer, offset?: integer, video_id: string }
- `POST https://api.mcp.ai/api/amara/list/videos` — Tool to list all videos. Use when you need to fetch a paginated list of videos with optional filters.
  - body: { sort?: string, team?: string, limit?: integer, owner?: string, offset?: integer, archive?: boolean, project?: string, language?: string, video_id?: string, video_url?: string }
- `POST https://api.mcp.ai/api/amara/make/video/url/primary` — 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.
  - body: { url_id: integer, primary: boolean, video_id: string }
- `POST https://api.mcp.ai/api/amara/perform/subtitle/action` — 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
  - body: { action: string, video_id: string, language_code: string }
- `POST https://api.mcp.ai/api/amara/send/message` — 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 
  - body: { team?: string, user?: string, content: string, subject: string }
- `POST https://api.mcp.ai/api/amara/update/subtitle/language` — 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.
  - body: { 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 }
- `POST https://api.mcp.ai/api/amara/update/video` — 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.
  - body: { team?: string, title?: string, project?: string, duration?: integer, metadata?: object, video_id: string, thumbnail?: string, description?: string, primary_audio_language_code?: string }
- `POST https://api.mcp.ai/api/amara/view/video/details` — Tool to view details of a specific video by ID. Use when you need complete metadata for a given video.
  - body: { video_id: string }

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

## More
- Page: https://mcp.ai/amara
- Agent spec (llms.txt): https://mcp.ai/amara/llms.txt
- Postman collection: https://mcp.ai/amara/postman.json