Getting Started with Echosaw's MCP Server

The Model Context Protocol (MCP) enables AI assistants like Claude Desktop and Cursor to interact directly with external tools and services. Echosaw's MCP server brings media intelligence capabilities into your AI-assisted development workflow, allowing you to analyze media, search your library, and manage your account through natural language conversations.

Remote Server Architecture

Echosaw provides a remote MCP server at https://mcp.echosaw.com that requires no local installation. The server uses streamable HTTP transport and OAuth 2.0 for authentication, making it compatible with modern MCP clients that support these standards. This approach eliminates the need to manage local server processes or handle API keys manually.

OAuth 2.0 Authentication Flow

The remote MCP server uses OAuth 2.0 with PKCE for secure authentication. When you connect from an MCP client like Claude Desktop, the flow works automatically:

1. The MCP client initiates the OAuth flow by redirecting to Echosaw's authorization endpoint
2. You authenticate using Echosaw's passwordless email-code system (no passwords required)
3. Upon successful authentication, the client receives an access token
4. This token is included in subsequent MCP tool requests, validated against Amazon Cognito JWKS

Each subscriber receives unique OAuth credentials (client_id and client_secret) provisioned at subscription time. These are shown once in your welcome email and stored securely—never shared or embedded in client-side code.

Available Tools

The MCP server exposes 14 tools covering the full range of Echosaw capabilities:

Media Analysis Tools

• echosaw_analyze_media_url — Submit a media URL for analysis
• echosaw_check_job_status — Check processing status
• echosaw_get_analysis_results — Retrieve completed intelligence reports
• echosaw_download_media — Generate presigned download URLs

Library Management Tools

• echosaw_search_media — Semantic search across your library
• echosaw_list_media — List all media with metadata and filters
• echosaw_list_folders — Browse folder structure
• echosaw_create_folder — Create new folders
• echosaw_move_media — Move items between folders
• echosaw_rename_folder — Rename existing folders
• echosaw_delete_folder — Delete folders
• echosaw_set_media_visibility — Toggle public library visibility

Account Tools

• echosaw_get_profile — Retrieve account and subscription information
• echosaw_get_organization — View organization details and membership

Configuration Examples

For Claude Desktop, add this to your MCP configuration:

{
  "mcpServers": {
    "echosaw": {
      "url": "https://mcp.echosaw.com"
    }
  }
}

For Cursor or other MCP clients, use the same URL—the OAuth flow will be handled automatically by the client. No additional configuration is required beyond ensuring you have an active subscription with MCP access enabled.

The MCP server transforms Echosaw from a web application into an integrated part of your AI-assisted development workflow. Ask Claude to analyze a video URL, search your media library for specific content, or organize your folders—all through natural language conversation.