MongoDB Atlas MCP Server

Instructions

Implementation Reference

• src/index.ts:313-336 (handler)

  The handler function that executes the list_atlas_clusters tool. It makes an API request to fetch clusters for the given projectId, enhances connection strings, and returns the formatted result.

  private async listAtlasClusters(input: ListClustersInput) {
    try {
      const url = `https://cloud.mongodb.com/api/atlas/v1.0/groups/${input.projectId}/clusters`;
      const result = await this.makeAtlasRequest(url, 'GET');
      
      // Add appName to connection strings in all clusters
      this.addAppNameToConnectionStrings(result);
      
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(result, null, 2)
        }]
      };
    } catch (error: any) {
      return {
        content: [{
          type: 'text',
          text: error.message
        }],
        isError: true
      };
    }
  }

• src/index.ts:37-39 (schema)

  TypeScript interface defining the input schema for listAtlasClusters: requires projectId.

  interface ListClustersInput {
    projectId: string;
  }

• src/index.ts:487-499 (registration)

  Tool registration in the ListTools response, including name, description, and inputSchema.

    name: 'list_atlas_clusters',
    description: 'Lists all clusters in an Atlas project.',
    inputSchema: {
      type: 'object',
      properties: {
        projectId: {
          type: 'string',
          description: 'The ID of the Atlas project.',
        },
      },
      required: ['projectId'],
    },
  }

• src/index.ts:564-566 (registration)

  Dispatch in CallToolRequest handler that routes to the listAtlasClusters method.

  case 'list_atlas_clusters':
    result = await this.listAtlasClusters(input as unknown as ListClustersInput);
    break;

• src/index.ts:538-542 (schema)

  Input validation for list_atlas_clusters parameters before execution.

  case 'list_atlas_clusters':
    if (!input.projectId) {
      throw new McpError(ErrorCode.InvalidParams, 'Invalid list clusters arguments');
    }
    break;