argus-media-mcp

MCP server for Argus — AI-native media asset management.

Search, upload, analyze, and manage media assets directly from Claude Desktop, Cursor, Windsurf, or any MCP-compatible client.

Setup

1. Get an API key

Sign up at argus.build and create an API key from the dashboard.

2. Configure your MCP client

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "argus": {
      "command": "npx",
      "args": ["-y", "argus-media-mcp"],
      "env": {
        "ARGUS_API_KEY": "ak_your_api_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "argus": {
      "command": "npx",
      "args": ["-y", "argus-media-mcp"],
      "env": {
        "ARGUS_API_KEY": "ak_your_api_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "argus": {
      "command": "npx",
      "args": ["-y", "argus-media-mcp"],
      "env": {
        "ARGUS_API_KEY": "ak_your_api_key_here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | search_assets | Search and list media assets by query, project, tags, or status | | get_asset | Get full details for a specific asset (analysis, colors, EXIF) | | upload_from_url | Upload a media file from a URL with automatic AI analysis | | argus_upload | Upload a local file by path with automatic AI analysis | | analyze_asset | Trigger AI analysis on an existing asset | | delete_asset | Permanently delete an asset | | get_usage | Check workspace usage, credits, and tier info |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ARGUS_API_KEY | Yes | Your Argus API key (starts with ak_) | | ARGUS_BASE_URL | No | API base URL (default: https://argus.build) |

License

MIT