# EchoWave

> EchoWave is an online video editor and media toolkit. Create, caption, voice-over, translate and render videos in the browser — or drive the whole thing programmatically with an AI agent through the EchoWave API and Model Context Protocol (MCP) server.

EchoWave is built to be operated by agents. Everything a person can do in the editor — start a project, add video/audio/images, overlay text, auto-generate and translate subtitles, add an AI voice-over, then render and download an MP4 — is available as REST endpoints and as MCP tools.

- Web app & editor: https://echowave.io/app
- API base: https://echowave.io/api/v1
- MCP server (Streamable HTTP): https://echowave.io/mcp
- Auth: OAuth 2.1 + PKCE (preferred) or an `X-API-Key` from account settings. Send a JWT access token as `Authorization: Bearer <token>` for resource `https://echowave.io/api/v1`.

## Agent capabilities (MCP tools / REST)

- [Account](https://echowave.io/openapi.json): `get_account` — profile, plan, usage. `GET /api/v1/account`.
- [Projects](https://echowave.io/openapi.json): `create_project`, `get_project`, `list_projects`, `update_project`, `delete_project`. `/api/v1/projects`.
- [Timeline](https://echowave.io/openapi.json): `add_segment`, `update_segment`, `delete_segment` — text, media, subtitles, waveform, progress bar, shape. `/api/v1/projects/{id}/segments`.
- [Media](https://echowave.io/openapi.json): `import_media` (by URL), upload. `/api/v1/media`.
- [AI voice-over](https://echowave.io/openapi.json): `list_voices`, `generate_speech` (TTS), `create_voice_clone`. `/api/v1/tts`, `/api/v1/voices`.
- [Subtitles](https://echowave.io/openapi.json): `transcribe_subtitles`, `translate_subtitles`. `/api/v1/subtitles`.
- [Render](https://echowave.io/openapi.json): `queue_render`, `get_render`, `list_renders`, `get_render_download`. `/api/v1/renders`.
- [Media tools](https://echowave.io/openapi.json): `run_tool` — trim, crop, compress, convert, rotate, flip, speed, reverse, loop, mute, split. `/api/v1/tools/{tool}`.
- [Stock](https://echowave.io/openapi.json): `search_stock_photos`. `/api/v1/stock/photos`.

## Discovery

- [OpenAPI 3.1 spec](https://echowave.io/openapi.json): full machine-readable REST contract.
- [API catalog](https://echowave.io/.well-known/api-catalog): RFC 9727 linkset (spec, docs, status).
- [MCP server card](https://echowave.io/.well-known/mcp/server-card.json): endpoint, auth and tool list.
- [Agent skills](https://echowave.io/.well-known/agent-skills/index.json): ready-made end-to-end workflows.
- [OAuth / OIDC discovery](https://echowave.io/.well-known/oauth-authorization-server): authorization + token endpoints, PKCE (S256).
- [Full reference](https://echowave.io/llms-full.txt): the complete LLM-readable API and tool reference.

## Popular use-cases (marketing pages)

- [Add text to video](https://echowave.io/tools/add-text-to-video)
- [Add subtitles](https://echowave.io/tools/add-subtitles)
- [Add a voice-over](https://echowave.io/tools/add-voice-over-to-video)
- [Music visualizer](https://echowave.io/tools/music-visualizer)
- [Podcast to video](https://echowave.io/tools/podcast-to-video)
- [Video compressor](https://echowave.io/tools/video-compressor)
- [Convert video](https://echowave.io/convert/mp4-to-mp3)

## Optional

- [Pricing](https://echowave.io/pricing)
- [Contact](https://echowave.io/contact)
- [Terms](https://echowave.io/terms)