The Echosaw Model Context Protocol (MCP) integration allows AI assistants and developer tools to interact with Echosaw's media intelligence capabilities directly. Submit media for analysis, retrieve results, and download source files — all from within your AI-powered development environment.
The Model Context Protocol is an open standard that enables AI models and developer tools to securely connect to external data sources and services. Echosaw's MCP server exposes the same capabilities as the REST API in a format optimized for AI assistant consumption.
Install the Echosaw MCP server globally via npm:
npm install -g @echosaw/mcp-serverRequires Node.js 18+ (the minimum version supported by the @modelcontextprotocol/sdk package) and an Echosaw API key (available from the API Reference page after subscribing to a Developer, Growth, Pro, or Agency plan).
| Variable | Required | Default | Description |
|---|---|---|---|
ECHOSAW_API_KEY | Yes | — | Your Echosaw API key |
ECHOSAW_API_URL | No | https://api.echosaw.com | API base URL (override for staging) |
Add the following to your Claude Desktop configuration file (claude_desktop_config.json):
{
"mcpServers": {
"echosaw": {
"command": "echosaw-mcp",
"env": {
"ECHOSAW_API_KEY": "your-api-key"
}
}
}
}Add to your Cursor MCP settings:
{
"mcpServers": {
"echosaw": {
"command": "echosaw-mcp",
"env": {
"ECHOSAW_API_KEY": "your-api-key"
}
}
}
}| Tool | Description |
|---|---|
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. |
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. |
echosaw_check_job_status | Retrieve the current processing state of an Echosaw analysis job, including whether the job is queued, processing, completed, or failed. |
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. |
echosaw_download_report | Download the report or output artifact produced by Echosaw for a completed analysis job. |
echosaw_analyze_media, returns a mediaId.echosaw_check_job_status.echosaw_get_analysis_results for the full intelligence report.echosaw_download_report for a presigned URL.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 |