mcp_list_connections
List all configured CosmosDB connections to discover available connection IDs for accessing different CosmosDB accounts and databases.
Instructions
List all available CosmosDB connections configured in this MCP server. Use this to discover which connection_id values you can use. Each connection points to a different CosmosDB account/database.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/dataOperations.ts:25-46 (handler)Main handler for mcp_list_connections tool. Fetches all registered CosmosDB connections via getRegisteredConnectionsInfo() and returns them with a default connection.
export const mcp_list_connections = async (): Promise<ToolResult<{ connections: Array<{id: string; databaseId: string; description?: string; isConnected: boolean}>; defaultConnection: string | null; }>> => { log(`Executing mcp_list_connections`); try { const connections = getRegisteredConnectionsInfo(); const defaultConn = connections.find(c => c.isConnected)?.id || connections[0]?.id || null; return { success: true, data: { connections, defaultConnection: defaultConn } }; } catch (error: any) { log(`Error in mcp_list_connections: ${error.message}`); return { success: false, error: error.message }; } }; - src/tools.ts:9-19 (schema)Tool registration with name 'mcp_list_connections' and empty inputSchema (no parameters required).
export const MCP_COSMOSDB_TOOLS = [ // 0. List Available Connections - NEW! { name: "mcp_list_connections", description: "List all available CosmosDB connections configured in this MCP server. Use this to discover which connection_id values you can use. Each connection points to a different CosmosDB account/database.", inputSchema: { type: "object", properties: {}, required: [] } }, - src/tools/index.ts:12-13 (registration)Re-exports mcp_list_connections from dataOperations module so it can be imported by the server.
export { mcp_list_connections, - src/server.ts:112-116 (registration)Switch-case in CallToolRequestSchema handler that routes 'mcp_list_connections' to the handler function.
switch (toolName) { // Connection management case 'mcp_list_connections': result = await toolHandlers.mcp_list_connections(); break; - src/db.ts:158-168 (helper)Helper function getRegisteredConnectionsInfo that reads registered connection configs and returns them with isConnected status.
/** * Get all registered connections info (without sensitive data) */ export const getRegisteredConnectionsInfo = (): Array<{id: string; databaseId: string; description?: string; isConnected: boolean}> => { return Array.from(registeredConnections.values()).map(conn => ({ id: conn.id, databaseId: conn.databaseId, description: conn.description, isConnected: activeConnections.has(conn.id) })); };