# MongoDB — API Agent Score

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

MongoDB scored 83/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 100/100 (A+)
- Developer Experience: 100/100 (A+)
- Agent Discovery: 89/100 (A)
- Agent Understanding: 79/100 (B)
- Agent Usability: 59/100 (D)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2.0") and media-type-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Schema coverage & depth — 3/3 enums are named types (not bare strings). Investigated: sdk 100%, spec 67%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: docs 100%, spec 50%, wellknown 0%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [pass] Example coverage — 61% example coverage (target 80%+). Investigated: spec 100%, docs 100%, sdk 100%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://www.mongodb.com/cloud/atlas/register; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://www.mongodb.com/docs/get-started/ has a runnable sample in the .md variant (https://www.mongodb.com/docs/get-started.md). Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 4 language(s) across docs (top: shell, javascript, go); 2/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 96% of operations + parameters have substantive descriptions. Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://www.mongodb.com/docs/database-tools/release-notes/database-tools-changelog/. Investigated: spec 100%, docs 100%, sdk 100%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (mongodb/docs, 3 snippets). Investigated: docs 100%, cli 100%, sdk 67%, mcp 0%, wellknown 0%.
- [warn] Docs reachable, not hard auth-gated — Content negotiation partially supported: 33 correct type, 0 wrong type, 17 HTML only. Investigated: docs 88%.
- [warn] llms.txt present, valid & comprehensive — No /llms-full.txt found at the candidate origins. Investigated: docs 79%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap present (15 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 10 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 — 3 of 50 pages have substantive content differences between markdown and HTML (avg 5% missing). Investigated: docs 60%.
- [warn] Docs structured data — JSON-LD on 9/11 assessed pages, but coverage is sparse or dateModified is missing. Investigated: docs 50%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Rate-limit signaling — 3 distinct rate-limit response headers documented. Investigated: spec 100%, docs 100%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [warn] Runnable collection with test scripts — No test scripts found in the workspace's collections. Investigated: platform 50%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%, sdk 0%.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

MongoDB's API program shows strong discoverability fundamentals, but two areas create real friction for partners and their AI agents today. First, there is no structured instructions file to orient agents on how to work with the APIs, meaning AI-powered integrations must guess at conventions rather than follow a clear playbook. Second, idempotency behaviors are undocumented and runnable examples are absent, which leaves partners exposed to duplicate-operation risks and forces agents to hallucinate request shapes instead of building against verified examples. Closing these gaps should be the immediate priority to make MongoDB's APIs reliably usable by both human partners and the AI agents they deploy.