documentdb-mcp¶
deterministic tool surface over DocumentDB, the MongoDB-compatible open-source document database built on PostgreSQL.
Official documentation
This site is the canonical reference for documentdb-mcp, maintained alongside
every release.
Overview¶
documentdb-mcp wraps the DocumentDB / MongoDB wire-protocol surface with granular,
per-operation MCP tools and a Pydantic-AI graph agent. It provides:
DocumentDBApi— apymongo-backed client that groups system, collections, users, CRUD, and analysis operations behind one tolerant facade.- Action-routed MCP tools — five togglable tool modules (system, collections,
users, CRUD, analysis) that minimize token overhead in an LLM context.
documentdb-agent) that speaks the Agent Control Protocol and exposes a web UI.
The server connects to any MongoDB-compatible endpoint, so it operates against DocumentDB or a standard MongoDB deployment interchangeably.
Explore the documentation¶
- :material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
- Deployment — run the MCP server and agent, Docker Compose, Caddy + Technitium.
- Usage — the MCP tools, the
DocumentDBApiclient, and the CLI. - Backing Platform — deploy DocumentDB with Docker.
- Overview — ecosystem role, tool modules, and configuration.
- Concepts — the
CONCEPT:DOCDB-*registry.
Quick start¶
Connect it to a DocumentDB / MongoDB endpoint:
export MONGODB_URI=mongodb://localhost:27017/
documentdb-mcp --transport streamable-http --host 0.0.0.0 --port 8000
See Installation and Deployment for the proxy, DNS).