# Mux — API Agent Score

> Score: 66/100 (Grade: C) | Domain: mux.com | Rubric: 1.0.0 | Checked: July 24, 2026

Mux scored 66/100 (C), classified "partially-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/mux)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 66/100 (C)
- Classification: partially-ready

## Category Scores

- API Design: 77/100 (B)
- Developer Experience: 59/100 (D)
- Agent Discovery: 82/100 (A)
- Agent Understanding: 74/100 (B)
- Agent Usability: 46/100 (F)

## Check Results

### API Design

- [warn] Machine-readable, versioned contract — info.version="v1" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [warn] Schema coverage & depth — 90% of operations have documented schemas (target 95%+). Investigated: spec 67%, sdk 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [warn] Auth declared & discoverable — Authentication applied on 121/131 operations (partial coverage). Investigated: spec 50%, docs 50%.
- [pass] Example coverage — Code samples in 7 language(s) across docs (top: javascript, shell, typescript); 3/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%, spec 0%, sdk 0%.

### Developer Experience

- [pass] Code samples in docs — Code samples in 7 language(s) across docs (top: javascript, shell, typescript); 3/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 94% of operations + parameters have substantive descriptions. Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://www.mux.com/docs/changelog. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Self-service developer portal — No signup page detected across conventional paths (/signup, /sign-up, /register, /get-started, /console/signup, /dashboard/signup, /try, /try-free, /free, /free-trial, /start, /start-free). Investigated: docs 0%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (websites/mux, 12973 snippets). Investigated: docs 100%, cli 100%, mcp 100%, sdk 88%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 196/691 sitemap doc pages (28%); 495 missing; 17 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 81%.
- [warn] Docs reachable, not hard auth-gated — 1 of 50 sampled pages return 200 for non-existent URLs (soft 404). Investigated: docs 50%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 9 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [pass] Operation purpose clarity — 99% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 1 of 44 pages have substantive content differences between markdown and HTML (avg 5% missing). Investigated: docs 65%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, sdk) is 8% (threshold 35% for full credit).
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 4 assessed pages (3 JS-rendered). Investigated: docs 0%.

### Agent Usability

- [pass] Pagination documented & consistent — Pagination params detected on 38 list endpoint(s). Investigated: spec 100%, docs 100%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Sandbox separation — No sandbox/test server declared across 148 server entries; no test-key prefixes documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Mux's API program shows real strengths in discovery and machine-readable contract quality, giving partners a solid foundation to find and evaluate the API. However, two areas create meaningful friction for partners and their AI agents today: agent understanding (missing structured context files and metadata that agents rely on to act autonomously) and agent usability (no sandbox separation, no runnable collection with test scripts, and gaps in idempotency and rate-limit documentation). Closing these gaps is the fastest path to letting partners — and the agents they deploy — integrate confidently without hand-holding.