# Wistia — how to use (mcp.ai)

Connect your Wistia account and use 10 tools for video and audio straight from your AI agent. Connect with your own API key. Wistia is a video marketing platform for hosting and managing media, channels, webinars, audience analytics, and account content.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_wistia?ms=1787296080000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `wistia_create_folder`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/wistia`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/wistia/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/wistia/create/folder` — Create a Wistia folder for organizing media, optionally make it public, and optionally set the specified email as its owner.
  - body: { name: string, is_public?: boolean, admin_email?: string }
- `POST https://api.mcp.ai/api/wistia/delete/folder` — Delete a Wistia folder by hashed ID. This is destructive, but deleted content may remain recoverable for a limited account-dependent window before permanent purge.
  - body: { folder_hashed_id: string }
- `POST https://api.mcp.ai/api/wistia/delete/media` — Delete one Wistia media item by hashed ID. This is destructive, but Wistia keeps deleted media recoverable for a limited account-dependent window before permanent purge.
  - body: { media_hashed_id: string }
- `POST https://api.mcp.ai/api/wistia/get/analytics/summary` — Return account-wide or single-media Wistia performance metrics for an inclusive start date and exclusive end date.
  - body: { end_date: string, start_date: string, media_hashed_id?: string }
- `POST https://api.mcp.ai/api/wistia/get/media` — Return detailed metadata, assets, folder placement, tags, and processing state for one Wistia media item.
  - body: { media_hashed_id: string, description_format?: string }
- `POST https://api.mcp.ai/api/wistia/import/media/from/url` — Start importing a publicly reachable media URL into Wistia, optionally into a folder. The response may be queued; call WISTIA_GET_MEDIA until its status is ready before using the media.
  - body: { url: string, name?: string, description?: string, low_priority?: boolean, folder_hashed_id?: string }
- `POST https://api.mcp.ai/api/wistia/search/content` — Search the connected Wistia account for media, folders, subfolders, channels, and channel episodes by text and optional filters.
  - body: { tags?: string[], query: string, created_after?: string, created_before?: string, resource_types?: string[] }
- `POST https://api.mcp.ai/api/wistia/set/media/archived/state` — Archive one or more media items, or restore archived media into a destination folder, and wait for Wistia's background job to finish. Requires the connected account to have access to Wistia's Archivin
  - body: { archived: boolean, folder_hashed_id?: string, media_hashed_ids: string[], wait_timeout_seconds?: integer }
- `POST https://api.mcp.ai/api/wistia/update/folder` — Update a Wistia folder's name, description, public visibility, or anonymous transfer settings.
  - body: { name?: string, is_public?: boolean, description?: string, folder_hashed_id: string, anonymous_can_upload?: boolean, anonymous_can_download?: boolean }
- `POST https://api.mcp.ai/api/wistia/update/media` — Update a Wistia media item's name, description, tags, or still image reference. Wistia returns descriptions as normalized HTML.
  - body: { name?: string, tags?: string[], description?: string, media_hashed_id: string, new_still_media_id?: string }

## Example prompts
- "What can I do in Wistia?"
- "Show me a summary of my Wistia account"

## More
- Page: https://mcp.ai/wistia
- Agent spec (llms.txt): https://mcp.ai/wistia/llms.txt
- Postman collection: https://mcp.ai/wistia/postman.json