Mux

# Mux Documentation for LLMs > Mux is how developers build online video. Mux provides a complete video platform that includes: > - Video hosting, encoding, and streaming infrastructure > - A modern, responsive video player with adaptive controls > - Video analytics and performance monitoring > - all with a great developer experience and surprisingly affordable pricing ## Quick start: What are you trying to do? - **Upload and stream a video file** → Start with /docs/core.txt, then /docs/guides/video.txt - **Build a video player** → /docs/guides/player.txt - **Handle file uploads from users** → /docs/guides/uploader.txt - **Track playback metrics and analytics** → /docs/guides/data.txt - **Set up a live stream** → /docs/core.txt (live streams section) + /docs/guides/video.txt - **Integrate with a web framework (Next.js, Rails, etc.)** → /docs/integrations.txt - **Need the full API reference** → /api-spec.json ## Common mistakes to avoid - **Never expose Mux API credentials in client-side code.** All API calls must come from a server. Use direct uploads or signed URLs for client-side operations. - **Don't poll the assets endpoint to check status.** Use webhooks instead. The `video.asset.ready` event tells you when an asset is ready for playback. - **Don't confuse Asset IDs with Playback IDs.** Asset IDs (used with api.mux.com) are for managing assets. Playback IDs (used with stream.mux.com) are for streaming to viewers. - **Don't expose stream keys in public code.** Treat stream keys like passwords. Anyone with the key can broadcast to your live stream. - **Don't hardcode playback URLs.** Playback IDs can change. Store the asset ID and look up playback IDs when needed, or store playback IDs separately. ## For AI agents If you're an AI agent that can use MCP (Model Context Protocol) tools, the Mux MCP server provides direct API access for video uploads, live streaming, and analytics queries. - Hosted MCP: https://mcp.mux.com - GitHub: https://github.com/muxinc/mux-node-sdk/tree/master/packages/mcp-server/vercel-function - Setup guide: /docs/integrations/mcp-server.md ## Notes - All documentation is automatically generated from the same source as our official documentation - API specifications include detailed endpoint descriptions, request/response formats, and examples following the OpenAPI specification - The documentation is regularly updated to reflect the latest features and capabilities - API version: v1 (stable) - Player version: @mux/mux-player 3.x, @mux/mux-player-react 3.x ## Guide collections - [/docs/core.txt](https://www.mux.com/docs/core.txt): Core Mux concepts (start here for most projects) - [/llms-full.txt](https://www.mux.com/llms-full.txt): All Mux docs in one file (if your context window is large enough) - [/docs/guides/video.txt](https://www.mux.com/docs/guides/video.txt): Upload, encode, and manage video assets - [/docs/guides/uploader.txt](https://www.mux.com/docs/guides/uploader.txt): Handle user uploads from browsers and mobile apps - [/docs/guides/player.txt](https://www.mux.com/docs/guides/player.txt): Embed video playback with Mux Player - [/docs/guides/data.txt](https://www.mux.com/docs/guides/data.txt): Track playback quality and viewer analytics - [/docs/guides/data-integrations.txt](https://www.mux.com/docs/guides/data-integrations.txt): Add Mux Data to third-party players (Video.js, HLS.js, etc.) - [/docs/integrations.txt](https://www.mux.com/docs/integrations.txt): Framework guides (Next.js, Rails, Laravel, etc.) and SDKs - [/docs/examples.txt](https://www.mux.com/docs/examples.txt): Example implementations and use cases - [/docs/pricing.txt](https://www.mux.com/docs/pricing.txt): Pricing and billing information ## API references - [/docs/api-reference/system.txt](https://www.mux.com/docs/api-reference/system.txt): Mux system API specification - [/docs/api-reference/video.txt](https://www.mux.com/docs/api-reference/video.txt): Mux Video API specification - [/docs/api-reference/data.t […truncated]