# Yoofooz API Readiness Report

## API
**Name:** MongoDB / Atlas APIs
**Docs URL:** https://www.mongodb.com/docs/mcp-server/
**Domain:** www.mongodb.com
**Generated At:** 2026-10-05T23:09:46.842285+00:00

## Certification
**Agent Readiness Score:** 75/100
**Certification Level:** Yoofooz Ready

## Agent Commerce Readiness
**Agent Commerce Score:** 50/100
**Agent Commerce Level:** Agent Commerce Emerging

This score is separate from the core Agent Readiness Score and evaluates MCP support, scoped agent identity, machine-native payments, consumption pricing, budget controls, rate controls, deterministic errors, auditability, least-privilege security, and agent observability.

## Category Scores
- Documentation Clarity: 10
- Machine Readable Spec: 10
- Authentication Clarity: 10
- Error Handling: 10
- Rate Limit Clarity: 10
- Agent Safe Workflow Support: 5
- Sandbox Availability: 0
- Webhook Event Support: 0
- Commercial Trust: 10
- Developer Experience: 10

## Strengths
- Documentation clarity
- Machine-readable specification (OpenAPI/GraphQL/etc.)
- Authentication model clarity
- Error handling and status codes
- Rate-limit / quota behavior
- Commercial trust (status, SLA, compliance)
- Developer experience (SDKs, quickstart, CLI)

## Risks
- Agent-safe workflow primitives (idempotency, retries) signal is partial; clearer documentation recommended.
- Sandbox / test-mode availability signal not detected in docs.
- Webhook / event support signal not detected in docs.

## Recommended Next Steps
- Strengthen: Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.
- Provide a sandbox / test mode with test API keys for safe agent testing.
- Expose webhook/event docs including event types, signature verification, and retry delivery.

## Evidence Signals

### Documentation clarity
- **Source:** https://www.mongodb.com/docs/manual/manual-1-llms.txt
- **Matched:** getting started, examples, docs, reference, overview
- **Evidence:** "# database manual - (manual) (part 1 of 10) > this part of the mongodb manual covers getting started, administration, and core concepts like clustered collections, change streams, and geospatial and other index types. - [about mongodb..."

- **Source:** https://www.mongodb.com/docs/llms.txt
- **Matched:** getting started, docs, guide, reference
- **Evidence:** "...library `llms.txt`. * if the task is about agent tooling, start with the mongodb mcp server or the agent-focused guides below. start here by task getting started * [get started](https://www.mongodb.com/docs/get-started.md): how to create an atlas cluster, connect to it, and load sample data using the atlas..."

### Machine-readable specification (OpenAPI/GraphQL/etc.)
- **Source:** https://www.mongodb.com/docs/atlas/api/api-rate-limit.md
- **Matched:** api spec, endpoints
- **Evidence:** "...application/json' \ -x get 'https://cloud.mongodb.com/api/atlas/v2/ratelimits?groupid= ' ``` to learn more, see the [atlas administration api specification.](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/) default rate limits **important:** rate limits are not part of the api..."

- **Source:** https://www.mongodb.com/docs/manual/manual-1-llms.txt
- **Matched:** json schema, schema
- **Evidence:** "...create an encryption schema for client-side field level encryption using json schema syntax to define encryption rules for document fields. - [fields and encryption..."

### Authentication model clarity
- **Source:** https://www.mongodb.com/docs/mcp-server/overview.md
- **Matched:** oauth, access token, client secret
- **Evidence:** "...you manually add the mongodb mcp server configuration and your oauth client credentials to a configuration file for your ai client. this setup path is best for working with programmatic agents. programmatic agents are..."

- **Source:** https://www.mongodb.com/docs/manual/core/security-internal-authentication.md
- **Matched:** secret key, authentication, authorization, keys
- **Evidence:** "...for cross-platform convenience. as a result, the following operations produce identical keys: ```bash echo -e 'mysecretkey' > key1 echo -e 'my secret key' > key1 echo -e 'my secret key\n' > key2 echo -e 'my secret key' > key3 echo -e 'my\r\nsecret\r\nkey\r\n' > key4 ``` keyfile format [keyfiles for..."

### Error handling and status codes
- **Source:** https://www.mongodb.com/docs/mcp-server/remote-mcp/rate-limits.md
- **Matched:** 429, 500, retry
- **Evidence:** "...what happens when you exceed a rate limit when you exceed a rate limit, the mongodb atlas managed mcp server returns an http [429 (too many requests)](https://developer.mozilla.org/en-us/docs/web/http/reference/status/429) response and does not process the request. if you..."

- **Source:** https://www.mongodb.com/docs/atlas/api/api-rate-limit.md
- **Matched:** 429, 500, retry
- **Evidence:** "...your allowed burst is limited to the available number of tokens in the bucket. when the bucket is empty, the atlas administration api returns a [429](https://developer.mozilla.org/en-us/docs/web/http/reference/status/429) (too many requests) http (hypertext transport protocol) status code for any..."

### Rate-limit / quota behavior
- **Source:** https://www.mongodb.com/docs/atlas/api/api-rate-limit.md
- **Matched:** rate limit, rate limits, retry-after, too many requests, 429, quota, limits
- **Evidence:** "> for the complete mongodb documentation index, see www.mongodb.com/docs/llms.txt # atlas administration api rate limits atlas uses *rate limiting* to control the rate of requests sent to the v2 api (application programming interface) endpoints within a specified..."

- **Source:** https://www.mongodb.com/docs/mcp-server/remote-mcp/rate-limits.md
- **Matched:** rate limit, rate limits, retry-after, too many requests, 429, limits
- **Evidence:** "> for the complete mongodb documentation index, see www.mongodb.com/docs/llms.txt # rate limits for mongodb atlas managed mcp server atlas applies rate limits to the requests that ai clients and agents send to the mongodb atlas managed mcp..."

### Agent-safe workflow primitives (idempotency, retries)
- **Source:** https://www.mongodb.com/docs/manual/manual-1-llms.txt
- **Matched:** metadata
- **Evidence:** "...manage sharded clusters by adding shards, migrating data, and configuring servers for metadata and application data storage. - [tcmalloc performance optimization for a self-managed..."

- **Source:** https://www.mongodb.com/docs/manual/manual-2-llms.txt
- **Matched:** validation
- **Evidence:** "...and replica set issues with retryable writes. - [rolling index builds](https://www.mongodb.com/docs/manual/core/rolling-index-builds.md) - [schema validation](https://www.mongodb.com/docs/manual/core/schema-validation.md): use schema validation to prevent unintended schema changes and data type errors...."

### Webhook / event support
- **Source:** https://www.mongodb.com/llms.txt
- **Matched:** events
- **Evidence:** "...log into your mongodb account. - [support](https://www.mongodb.com/services/support): for atlas and enterprise customers. - [events](https://www.mongodb.com/events/mongodb-local): learn from experts at mongodb.local events. - [mongodb trust..."

- **Source:** https://www.mongodb.com/docs/llms.txt
- **Matched:** events
- **Evidence:** "...config, faq, troubleshooting (part 3 of 5)](https://www.mongodb.com/docs/ops-manager/current/ops-manager-3-llms.txt) * [ops manager – audit events, automation config, roles, troubleshooting (part 4 of 5)](https://www.mongodb.com/docs/ops-manager/current/ops-manager-4-llms.txt) * [ops manager –..."

### Commercial trust (status, SLA, compliance)
- **Source:** https://www.mongodb.com/llms.txt
- **Matched:** trust center, support, security
- **Evidence:** "...for atlas and enterprise customers. - [events](https://www.mongodb.com/events/mongodb-local): learn from experts at mongodb.local events. - [mongodb trust center](https://www.mongodb.com/products/platform/trust): we are dedicated to securing and protecting your data. -..."

- **Source:** https://www.mongodb.com/docs/manual/manual-2-llms.txt
- **Matched:** support, security, compliance
- **Evidence:** "...reference](https://www.mongodb.com/docs/manual/core/queryable-encryption/reference.md): explore components of queryable encryption, including supported operations and mongoclient options. - [compatibility](https://www.mongodb.com/docs/manual/core/queryable-encryption/reference/compatibility.md):..."

### Developer experience (SDKs, quickstart, CLI)
- **Source:** https://www.mongodb.com/docs/llms.txt
- **Matched:** client libraries, cli, guides, tutorials
- **Evidence:** "...* [voyage ai models](https://www.mongodb.com/docs/voyageai/llms.txt) using drivers and client libraries * [c driver](https://www.mongodb.com/docs/languages/c/c-driver/current/llms.txt) * [c++..."

- **Source:** https://www.mongodb.com/llms.txt
- **Matched:** developer tools, cli, tutorials
- **Evidence:** "...- [security](https://www.mongodb.com/products/capabilities/security): our built-in security controls and customizable guardrails reduce risk. developer tools - [ephemeral clusters](https://www.mongodb.com/products/tools/atlas-ephemeral-clusters): instantly create a live atlas ephemeral cluster with no..."

## AI Analyst Summary
AI analysis unavailable: NVIDIA analysis failed: http 410

## Yoofooz Summary
This API has been evaluated for autonomous AI-agent usability. The score reflects documentation quality, machine-readable specification signals, authentication clarity, error handling, workflow safety, commercial trust, and developer experience.