🚀 Azure Cosmos DB MCP Toolkit — Public Preview Announcement

[sajeetharan]

🚀 Azure Cosmos DB MCP Toolkit — Public Preview Announcement

We’re excited to announce the public preview of the Azure Cosmos DB MCP Toolkit, an open-source implementation of the Model Context Protocol (MCP) that enables AI agents and LLMs to securely interact with Azure Cosmos DB.

This toolkit bridges the gap between intelligent applications and globally distributed data, allowing agents to retrieve, search, and understand your data without custom integration code.

⭐ What Is the Azure Cosmos DB MCP Toolkit?

The toolkit exposes Azure Cosmos DB through standardized MCP tools, making it easy for AI agents to perform database operations safely and intelligently.

Included MCP Tools

list_databases — Discover all databases

list_collections — Explore containers

get_recent_documents — Retrieve the most recent documents

find_document_by_id — Fetch a document by ID

text_search — Search documents using CONTAINS

vector_search — Semantic search using embeddings

get_approximate_schema — Infer schema from sample documents

🔐 Secure by Design

The MCP Toolkit supports enterprise-grade security:

Microsoft Entra ID OAuth2 authentication

Role-Based Access Control (RBAC)

Managed identities for passwordless access

CORS controls for secure web clients

🚀 Why Use the MCP Toolkit?

• Build agents in hours, not weeks
• Native vector search for RAG and contextual apps
• Cosmos DB autoscale + serverless for variable demand
• Global distribution with low-latency reads
• Direct integration with LangChain, Semantic Kernel, Foundry, and MCP-native frameworks

🤖 Microsoft Foundry Integration

The toolkit integrates directly with Microsoft Foundry, enabling agents to combine LLM reasoning with Cosmos DB’s speed and scale.

Adding Cosmos DB tools in Foundry

1. Open your Foundry project
2. Go to Build → Create Agent
3. Under Tools, click + Add
4. Switch to Catalog
5. Choose Azure Cosmos DB and click Create

🛠️ Extending the Toolkit

The toolkit is designed to be extensible.
Add your own custom tools by extending the CosmosDbToolsService class.

Contributions are welcome!

Contribution guide → https://github.com/AzureCosmosDB/MCPToolKit/blob/main/CONTRIBUTING.md

📘 Documentation & Resources

Full Documentation:
https://github.com/AzureCosmosDB/MCPToolKit

Quick Start:
https://github.com/AzureCosmosDB/MCPToolKit#quick-start

Repository:
https://github.com/AzureCosmosDB/MCPToolKit

🙌 We Want Your Feedback

Try it out and let us know what you think.
Your feedback will help shape the roadmap and next set of MCP tools.

If you build something cool or extend the toolkit — share it with the community!