microsoft / microsoft/documentdb-mcp

[Positioning] PM Decision — AI/agent-first framing

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

@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

  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.