mcp_list_containers

Retrieve all containers within a CosmosDB database to analyze structure and manage document storage.

Instructions

List all containers in the CosmosDB database

Input Schema

TableJSON Schema

Name	Required	Description	Default
`random_string`	Yes	Dummy parameter for no-parameter tools

Implementation Reference

src/tools/containerAnalysis.ts:32-54 (handler)

The main asynchronous handler function that lists all containers in the current CosmosDB database, maps their info to ContainerInfo type, and returns ToolResult.

export const mcp_list_containers = async (): Promise<ToolResult<ContainerInfo[]>> => {
  console.log('Executing mcp_list_containers');

  try {
    const database = getDatabase();
    const { resources: containers } = await database.containers.readAll().fetchAll();
    
    const containersInfo: ContainerInfo[] = containers.map((container: any) => ({
      id: container.id,
      partitionKey: container.partitionKey ? {
        paths: container.partitionKey.paths || [],
        kind: container.partitionKey.kind
      } : undefined,
      indexingPolicy: container.indexingPolicy,
      etag: container._etag,
      timestamp: container._ts ? new Date(container._ts * 1000) : undefined
    }));

    return { success: true, data: containersInfo };
  } catch (error: any) {
    console.error(`Error in mcp_list_containers: ${error.message}`);
    return { success: false, error: error.message };
  }

src/tools.ts:19-32 (schema)

JSON Schema definition for the tool registration, including input schema (uses dummy param since tool takes no arguments). Used in ListTools response.

{
  name: "mcp_list_containers",
  description: "List all containers in the CosmosDB database",
  inputSchema: {
    type: "object",
    properties: {
      random_string: {
        type: "string",
        description: "Dummy parameter for no-parameter tools"
      }
    },
    required: ["random_string"]
  }
},

src/server.ts:94-95 (registration)
Dispatch case in the CallTool request handler that invokes the mcp_list_containers tool handler.
```
case 'mcp_list_containers':
    result = await toolHandlers.mcp_list_containers();
```

src/tools/types.ts:14-24 (schema)

TypeScript interface defining the structure of ContainerInfo returned in the tool's output.

export interface ContainerInfo {
  id: string;
  partitionKey?: {
    paths: string[];
    kind?: string;
  };
  throughput?: number;
  indexingPolicy?: any;
  etag?: string;
  timestamp?: Date;
}

src/server.ts:64-66 (registration)
Registration of the ListTools handler which returns the array of tools including mcp_list_containers with its schema.
```
server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: MCP_COSMOSDB_TOOLS
}));
```

MCP CosmosDB