# Eranol — how to use (mcp.ai)

Connect your Eranol account and use 10 tools for video and audio straight from your AI agent. Connect with your own API key. Eranol provides API-driven video, audio, and media conversion workflows powered by FFmpeg.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_eranol?ms=1787293500000`
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. `eranol_caption_video`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/eranol`
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/eranol/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/eranol/caption/video` — Transcribe a publicly downloadable video's audio, burn styled captions into the video, and produce subtitles. This asynchronous processing call consumes Eranol credits; the smallest live-tested media 
  - body: { language?: string, position?: string, font_size?: integer, video_url: string, font_color?: string, padding_top?: integer, outline_color?: string, outline_width?: integer, padding_bottom?: integer, max_words_per_line?: integer, max_segment_duration?: number }
- `POST https://api.mcp.ai/api/eranol/concat/videos` — Join two or more ordered, publicly downloadable video clips, optionally with one transition between clips. This asynchronous processing call consumes Eranol credits; observed processing cost at least 
  - body: { clips: object[], transition?: object }
- `POST https://api.mcp.ai/api/eranol/convert/media` — Convert a publicly downloadable media URL to MP3, WAV, JPG, WebP, MP4, or WebM using one fixed route selected by output_format. This asynchronous processing call consumes Eranol credits; the smallest 
  - body: { source_url: string, output_format: string }
- `POST https://api.mcp.ai/api/eranol/delete/job` — Cancel or delete an Eranol media job and remove its generated output immediately.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/eranol/enhance/audio` — Enhance speech in publicly downloadable audio or video with noise reduction, voice profiling, optional loudness normalization, and output-format controls. This processing call consumes Eranol credits;
  - body: { media_url: string, keep_video?: boolean, post_filter?: boolean, output_format?: string, voice_profile?: string, loudness_target?: number, attenuation_limit_db?: number }
- `POST https://api.mcp.ai/api/eranol/get/account/credits` — Return the connected Eranol account ID and remaining processing credits.
- `POST https://api.mcp.ai/api/eranol/get/job/result` — Return a completed Eranol media job's download URL and output metadata, or its status and progress while still processing. Generated output URLs expire after 24 hours.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/eranol/get/job/status` — Return an Eranol media job's state, progress, timestamps, error, and nested result metadata when available.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/eranol/trim/video` — Create a losslessly trimmed clip from a publicly downloadable video URL and start/end times. This asynchronous processing call consumes Eranol credits; the smallest live-tested media operation cost 10
  - body: { video_url: string, end_seconds: number, start_seconds: number }
- `POST https://api.mcp.ai/api/eranol/watermark/video` — Add an image watermark to a publicly downloadable video with position, margin, opacity, and scale controls. This asynchronous processing call consumes Eranol credits; the smallest live-tested processi
  - body: { scale?: number, margin?: integer, opacity?: number, position?: string, video_url: string, watermark_url: string }

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

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