microsoft / microsoft/documentdb-mcp

[Positioning] Add 'Use this when / Use something else when' section

Open
#72 0 comments 0 reactions 1 assignee View on GitHub

@khelanmodi is already working on this.

Since May 13, 2026.

documentation positioning tier-1
Dominant language
TypeScript
Stars
2
Forks
4
Avg merge
6d 21h
Merged PRs (30d)
3

Description

Goal

Set expectations explicitly; reduce wrong-fit issues.

What to ship

A README section near the top:

Use this when…

  • You're building an AI agent or LLM-powered app that needs to read or modify data in Azure DocumentDB.
  • You need Entra-secured access from a hosted MCP endpoint.
  • You want defense-in-depth (RBAC, allow/deny lists, audit logging) for an LLM-facing data surface.

Use something else when…

  • You're targeting MongoDB Atlas → see mongodb-mcp-server.
  • You're writing CRUD code by hand → use the DocumentDB SDK directly.
  • You're doing routine DB admin → use Compass, mongosh, or the Azure portal.
  • You need a query result set with millions of rows → MCP is not the right shape; use the SDK.

Acceptance criteria

  • Clear pointers to alternatives in the "not us" bullets.
  • Reviewed for accuracy (don't disparage alternatives — just point to them).

Depends on

  • Positioning Decision: Audience.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.