microsoft / microsoft/documentdb-mcp
[Positioning] PM Decision — AI/agent-first framing
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 the server explicitly AI/agent-first, or general-purpose?
Why this matters
Resolves several second-order questions:
Why aren't there more tools?→ Because more tools degrade agent selection accuracy.Why doesn't it support X feature?→ Because we curate for agent use, not API coverage.How do I extend it?→ Write a skill, not a fork.
Recommendation
Yes, AI/agent-first. The MCP server is the API surface for LLM agents talking to DocumentDB. Skills + agents are the application layer on top. This aligns with:
- The MCP ecosystem direction.
- The existence of
documentdb-agent-kit. - The deliberate tool consolidation (~18 tools, not 40).
Acceptance criteria
- Decision documented.
- README framed as "agent-first" in the lede.
- Tools-catalog page references the consolidation principle.
- Extensibility doc points users to skills, not forks.
Blocks
- Tools catalog page (Tier 2 DX).
- Positioning statement.
- Comparison table.
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.