# MotherDuck — API Agent Score

> Score: 84/100 (Grade: A) | Domain: motherduck.com | Rubric: 1.0.0 | Checked: July 24, 2026

MotherDuck scored 84/100 (A), classified "ai-ready".

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

## Summary

- Overall: 84/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 100/100 (A+)
- Agent Discovery: 97/100 (A+)
- Agent Understanding: 82/100 (A)
- Agent Usability: 60/100 (C)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — 116/117 (99%) public params are fully typed (no any/**kwargs). Analyzer reports not all methods have a derivable input schema. Investigated: sdk 100%, spec 83%.
- [warn] Machine-readable, versioned contract — info.version="1.0.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — 73% example coverage (target 80%+). Investigated: spec 100%, docs 100%, sdk 100%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://motherduck.com/get-started/ (CSR-rendered — body classifier inconclusive); free tier / sandbox documented in pricing/docs. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://motherduck.com/docs/getting-started/ has a runnable sample in the .md variant (https://motherduck.com/docs/getting-started.md). Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 3 language(s) across docs (top: javascript, go, typescript); 0/18 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 82% description completeness (target 90%+). Investigated: spec 100%, sdk 64%.
- [pass] Changelog published — Newest official SDK activity 22 day(s) ago. Investigated: sdk 100%, spec 0%, docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (websites/motherduck, 6261 snippets). Investigated: docs 100%, sdk 83%, cli 0%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 88%, sdk 0%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

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

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Motherduck's API program shows strong foundations in API design, discovery, and documentation quality — partners and agents can find and read your surface without friction. The two areas that need immediate attention are agent context and runnable truth: there is no machine-readable instruction file to tell AI agents how to work with your API, and there are no executable collections with test scripts for partners or their coding agents to validate integrations against. Closing these two gaps will meaningfully accelerate partner onboarding and reduce integration errors before they reach production.