get_atlas_connection_strings

Instructions

Implementation Reference

• src/index.ts:215-240 (handler)

  The main handler function that retrieves the cluster details from the MongoDB Atlas API, enhances the connection strings by adding an appName parameter using a helper function, and returns the result in MCP format.

  private async getAtlasConnectionStrings(input: ConnectionStringsInput) {
    try {
      const url = `https://cloud.mongodb.com/api/atlas/v1.0/groups/${input.projectId}/clusters/${input.clusterName}`;
      const result = await this.makeAtlasRequest(url, 'GET');
      
      // Add appName to connection strings if they exist
      if (result.connectionStrings) {
        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:32-35 (schema)

  TypeScript interface defining the expected input parameters for the getAtlasConnectionStrings handler.

  interface ConnectionStringsInput {
    projectId: string;
    clusterName: string;
  }

• src/index.ts:460-477 (registration)

  Tool registration in the MCP listTools handler, defining the tool name, description, and input schema.

  {
    name: 'get_atlas_connection_strings',
    description: 'Retrieves connection strings for a cluster in an existing Atlas project.',
    inputSchema: {
      type: 'object',
      properties: {
        projectId: {
          type: 'string',
          description: 'The ID of the Atlas project.',
        },
        clusterName: {
          type: 'string',
          description: 'The name of the cluster.',
        },
      },
      required: ['projectId', 'clusterName'],
    },
  },

• src/index.ts:558-560 (registration)

  Dispatch logic in the MCP callTool handler that invokes the getAtlasConnectionStrings method when the tool is called.

  case 'get_atlas_connection_strings':
    result = await this.getAtlasConnectionStrings(input as unknown as ConnectionStringsInput);
    break;

• src/index.ts:264-311 (helper)

  Supporting helper method that modifies Atlas cluster response connection strings by appending an appName query parameter for tracking.

  private addAppNameToConnectionStrings(result: any) {
    const appName = "devrel.integration.mcp-atlas";
    
    // Helper function to safely add appName parameter to a connection string
    const addAppNameParam = (connectionString: string): string => {
      if (!connectionString) return connectionString;
      
      // Add appName parameter
      return connectionString + (connectionString.includes('?') ? '&' : '?') + `appName=${appName}`;
    };
    
    // Handle single cluster object
    if (result.connectionStrings) {
      // Add appName to standard connection string
      if (result.connectionStrings.standard) {
        result.connectionStrings.standard = addAppNameParam(result.connectionStrings.standard);
      }
      
      // Add appName to standardSrv connection string
      if (result.connectionStrings.standardSrv) {
        result.connectionStrings.standardSrv = addAppNameParam(result.connectionStrings.standardSrv);
      }
      
      // Add appName to other connection string formats
      if (result.mongoURI) {
        result.mongoURI = addAppNameParam(result.mongoURI);
      }
      
      if (result.mongoURIWithOptions) {
        result.mongoURIWithOptions = addAppNameParam(result.mongoURIWithOptions);
      }
      
      if (result.srvAddress) {
        result.srvAddress = addAppNameParam(result.srvAddress);
      }
    }
    
    // Handle array of clusters (for listAtlasClusters)
    if (result.results && Array.isArray(result.results)) {
      result.results.forEach((cluster: any) => {
        if (cluster.connectionStrings) {
          this.addAppNameToConnectionStrings(cluster);
        }
      });
    }
    
    return result;
  }