documentdb-mcp

DocumentDB MCP Server + A2A Agent for the agent-utilities ecosystem — a typed, 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, action-routed MCP tools and a Pydantic-AI graph agent. It provides:

• DocumentDBApi — a pymongo-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.
• An integrated A2A agent — a Pydantic-AI graph agent (console script 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

• 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 DocumentDBApi client, and the CLI.
• Backing Platform — deploy DocumentDB with Docker.
• Overview — ecosystem role, tool modules, and configuration.
• Concepts — the CONCEPT:DOCDB-* registry.

Quick start

pip install documentdb-mcp
documentdb-mcp                   # stdio MCP server (default transport)

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 full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, DNS).