echosaw

# Echosaw Media Intelligence ## Overview Echosaw is a media intelligence platform — not just a transcription tool. It analyzes video, audio, and image files using AI (Amazon Rekognition, Transcribe, Comprehend, and Bedrock/Claude) and produces structured intelligence reports. Each report can include: - **Transcripts** — Full speech-to-text output with timestamps - **Content moderation signals** — Flagged content categories and confidence scores - **Sentiment analysis** — Emotional tone detected across the media - **Visual object labels** — Recognized objects, scenes, and activities in video/image frames - **Geographic metadata** — Reverse-geocoded location data (Growth tier and above) - **LLM-generated summaries** — AI-authored narrative summaries powered by Bedrock/Claude The analysis pipeline: upload → malware scan (GuardDuty) → media probe (validation, metadata) → AI analysis (transcription, visual recognition, content moderation, sentiment) → LLM report generation (Bedrock/Claude) → packaging and delivery. ## Available Tools | Tool | Description | Required Parameters | | :--- | :--- | :--- | | `echosaw_analyze_media` | Upload an audio, video, or image file to Echosaw for asynchronous media analysis. Returns a job ID used to track processing and retrieve results. | `filePath` (string) — Absolute path to the media file on disk; `mediaType` (string) — One of: `video`, `audio`, `image` | | `echosaw_analyze_media_url` | Submit a publicly accessible or authorized media URL to Echosaw for asynchronous analysis without uploading the file directly. Returns a job ID used to track processing and retrieve results. | `url` (string) — HTTP(S) URL of the media file; `mediaType` (string) — One of: `video`, `audio`, `image` | | `echosaw_check_job_status` | Retrieve the current processing state of an Echosaw analysis job, including whether the job is queued, processing, completed, or failed. | `mediaId` (string) — The mediaId returned by `echosaw_analyze_media` or `echosaw_analyze_media_url` | | `echosaw_get_analysis_results` | Retrieve structured analysis results generated by Echosaw for a completed job, including summaries, transcripts, detected entities, events, and other intelligence outputs. Supports an optional `section` parameter to reduce response size. | `mediaId` (string) — The mediaId of a completed analysis; `section` (string, optional) — One of: `summary`, `transcript`, `safety`, `insights`, `metadata`, `downloads`, `all` | | `echosaw_download_media` | Generate a presigned download URL for the source media file associated with a completed analysis job. The URL is valid for 1 hour. | `mediaId` (string) — The mediaId of the media to download | | `echosaw_search_media` | Semantic search across your analyzed media library. Returns ranked results with titles, summaries, transcript snippets, and relevance scores. | `query` (string) — Natural language search query | | `echosaw_list_media` | List media items in your Echosaw library with metadata including filename, type, status, size, and duration. | `limit` (number, optional) — Max items to return (default 25) | | `echosaw_get_profile` | Retrieve your Echosaw account profile including subscription tier, email, organization membership, and trial status. | (none) | ## Workflow Follow these steps to analyze media with Echosaw: 1. **Submit media** — Use `echosaw_analyze_media` (local file) or `echosaw_analyze_media_url` (remote URL) to submit media for analysis. The tool returns a `mediaId` and `jobId`. 2. **Poll status** — Call `echosaw_check_job_status` with the `mediaId` to monitor progress. The job progresses through states: `PENDING` → `PROCESSING` → `COMPLETE`. If still processing, wait a minute or two and check again. 3. **Get results** — Once the status is `COMPLETE`, call `echosaw_get_analysis_results` to retrieve the full intelligence report including summaries, transcripts, detected entities, and other outputs. 4. **Download source media** — Optionally call `echosaw_download_media` to get a presigned download URL for the source media file (valid for 1 hour). 5. **Search your library** — Use `echosaw_search_media` to find previously analyzed media by topic, content, or keyword. 6. **Browse your library** — Use `echosaw_list_media` to see all media items in your library. 7. **Check your account** — Use `echosaw_get_profile` to see your subscription tier, trial status, and account details. ### Example Conversation - **"Analyze the video at /Users/me/Downloads/interview.mp4"** → calls `echosaw_analyze_media`, returns a `mediaId` - **"What's the status of that analysis?"** → calls `echosaw_check_job_status` - **"Show me the results"** → calls `echosaw_get_analysis_results` for the full intelligence report - **"Get me a download link"** → calls `echosaw_download_media` for a presigned URL - **"Search my media for anything about product launches"** → calls `echosaw_search_media` - **"What media do I have in my library?"** → calls `echosaw_list_media` - **"What plan am I on?"** → calls `echosaw_get_profile` ## Supported Formats | Format | Type | Notes | | :--- | :--- | :--- | | MP4 | Video | Primary video format; max duration 210 minutes (varies by tier) | | MP3 | Audio | Primary audio format; max duration 210 minutes (varies by tier) | | JPEG | Image | Primary image format | Additional supported formats via the MCP server: MOV, AVI, WebM, MKV (video); WAV, FLAC, AAC, OGG, M4A (audio); PNG, GIF, WebP, BMP, TIFF (image). ## Pricing Echosaw offers a **free trial** of the web UI — no payment required: - **5 analysis uploads** included - **14-day trial window** - Full Premium-tier feature access during trial - Start a trial at [echosaw.com](https://echosaw.com) by entering your email - **Note:** The free trial applies to the web interface only. MCP server access requires a paid plan (Developer, Growth, Pro, or Agency) with an API key. Subscription tiers (monthly billing plus per-minute usage): | Tier | Monthly | Audio Usage | Audio + Video Usage | | :--- | :--- | :--- | :--- | | Developer | $49/mo | $0.37/min | $0.58/min | | Growth | $99/mo | $0.32/min | $0.53/min | | Pro | $149/mo | $0.27/min | $0.48/min | | Agency | $499/mo | $0.22/min | $0.43/min | For full pricing details and plan comparison, visit [echosaw.com/pricing](https://echosaw.com/pricing). > **Deprecated local install:** `npm install -g @echosaw/mcp-server` (stdio, API key auth). Use the remote server instead. ## Authentication (Remote Server — Recommended) The remote MCP server at `https://mcp.echosaw.com` uses OAuth 2.0 for authentication. MCP clients that support OAuth (such as Claude Desktop, claude.ai, and Claude Code) will handle the authentication flow automatically. No API key configuration is needed — the OAuth flow connects to your Echosaw account directly. ## Authentication (Local Server — Deprecated) 1. **Get an API key** — Subscribe to a Developer, Growth, Pro, or Agency plan at [echosaw.com/pricing](https://echosaw.com/pricing). Your API key is provided in the welcome email and shown once (it is not recoverable after that). 2. **Set the environment variable** — Configure `ECHOSAW_API_KEY` in your MCP client: ```json { "mcpServers": { "echosaw": { "command": "echosaw-mcp", "env": { "ECHOSAW_API_KEY": "your-api-key" } } } } ``` The same API key works for both the MCP server and the REST API. Authentication uses the API key only — no additional Cognito/JWT tokens are required. ## Response Format All tools return a standardized JSON response envelope: | Field | Type | Description | | :--- | :--- | :--- | | `success` | boolean | Whether the operation succeeded | | `tool` | string | The tool that produced this response | | `responseVersion` | string | Response schema version (currently "1.0") | | `data` | object | Tool-specific result data | | `message` | string? | Human-readable summary | | `error` | string? | Error description (when success is false) | | `nextAction` | object? | Suggested next tool to call | ## Links - **Homepage**: [echosaw.com](https://echosaw.com) - **MCP Integration Guide**: [echosaw.com/developers/mcp-integration](https://echosaw.com/developers/mcp-integration) - **API Reference**: [echosaw.com/developers/api-reference](https://echosaw.com/developers/api-reference) - **Pricing**: [echosaw.com/pricing](https://echosaw.com/pricing)