microsoft / microsoft/documentdb-mcp
[Positioning] PM Decision — Scope: DocumentDB-only vs. Mongo-compatible (incl. Atlas)?
Open
@khelanmodi is already working on this.
Since May 13, 2026.
decision
positioning
tier-1
- Dominant language
- TypeScript
- Stars
- 2
- Forks
- 4
- Avg merge
- 6d 21h
- Merged PRs (30d)
- 3
Description
Decision needed
Is this MCP server:
- (A) DocumentDB-only — primary target is Azure DocumentDB; other backends are unsupported / undocumented.
- (B) DocumentDB-first, Mongo-compatible best-effort — test against DocumentDB, don't gate Atlas usage, don't write Atlas-specific code, set expectations in docs.
- (C) Generic Mongo-compatible — Atlas first-class; compete directly with
mongodb-mcp-server.
Why this matters
- Drives API choices (Mongo wire protocol vs. Data API, etc.).
- Drives OSS positioning and support commitment.
- Drives whether features that only exist in one backend are gated.
- Drives README messaging.
Recommendation
(B). Keeps the value prop sharp (Azure-native, Entra-integrated, security-first) without slamming the door on the curious Atlas user. Avoids competing head-on with mongodb-mcp-server without a clear differentiator.
Acceptance criteria
- Decision documented in this issue.
- README updated to match the chosen scope.
- Test matrix updated accordingly.
Blocks
Several DX issues depend on knowing the scope before writing docs.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.