MongoDB Atlas Administration API — Monitoring and Logs

naftiko: 1.0.0-alpha2
info:
  label: MongoDB Atlas Administration API — Monitoring and Logs
  description: 'MongoDB Atlas Administration API — Monitoring and Logs. 14 operations. Lead operation: Download Logs for One
    Cluster Host in One Project. Self-contained Naftiko capability covering one Mongodb business surface.'
  tags:
  - Mongodb
  - Monitoring and Logs
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MONGODB_API_KEY: MONGODB_API_KEY
capability:
  consumes:
  - type: http
    namespace: atlas-monitoring-and-logs
    baseUri: https://cloud.mongodb.com
    description: MongoDB Atlas Administration API — Monitoring and Logs business capability. Self-contained, no shared references.
    resources:
    - name: api-atlas-v2-groups-groupId-clusters-hostName-logs-logName}.gz
      path: /api/atlas/v2/groups/{groupId}/clusters/{hostName}/logs/{logName}.gz
      operations:
      - name: downloadgroupclusterlog
        method: GET
        description: Download Logs for One Cluster Host in One Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: hostName
          in: path
          type: string
          description: Human-readable label that identifies the host that stores the log files that you want to download.
          required: true
        - name: logName
          in: path
          type: string
          description: Human-readable label that identifies the log file that you want to return. To return audit logs, enable
            *Database Auditing* for the specified project.
          required: true
        - name: endDate
          in: query
          type: integer
          description: Specifies the date and time for the ending point of the range of log messages to retrieve, in the number
            of seconds that have elapsed since the UNIX epoch. This
        - name: startDate
          in: query
          type: integer
          description: Specifies the date and time for the starting point of the range of log messages to retrieve, in the
            number of seconds that have elapsed since the UNIX epoch. Th
    - name: api-atlas-v2-groups-groupId-hosts-processId-fts-metrics
      path: /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics
      operations:
      - name: listgrouphostftsmetrics
        method: GET
        description: Return All Atlas Search Metric Types for One Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-atlas-v2-groups-groupId-hosts-processId-fts-metrics-indexes-databaseName-col
      path: /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/measurements
      operations:
      - name: listgrouphostftsmetricindexmeasurements
        method: GET
        description: Return All Atlas Search Index Metrics for One Namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: metrics
          in: query
          type: array
          description: List that contains the measurements that MongoDB Atlas reports for the associated data series.
          required: true
    - name: api-atlas-v2-groups-groupId-hosts-processId-fts-metrics-indexes-databaseName-col
      path: /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/{indexName}/measurements
      operations:
      - name: getgrouphostftsmetricindexmeasurements
        method: GET
        description: Return Atlas Search Metrics for One Index in One Namespace
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: metrics
          in: query
          type: array
          description: List that contains the measurements that MongoDB Atlas reports for the associated data series.
          required: true
    - name: api-atlas-v2-groups-groupId-hosts-processId-fts-metrics-measurements
      path: /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/measurements
      operations:
      - name: listgrouphostftsmetricmeasurements
        method: GET
        description: Return Atlas Search Hardware and Status Metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: metrics
          in: query
          type: array
          description: 'List that contains the metrics that you want MongoDB Atlas to report for the associated data series.
            If you don''t set this parameter, this resource returns all '
          required: true
    - name: api-atlas-v2-groups-groupId-processes
      path: /api/atlas/v2/groups/{groupId}/processes
      operations:
      - name: listgroupprocesses
        method: GET
        description: Return All MongoDB Processes in One Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-atlas-v2-groups-groupId-processes-processId
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}
      operations:
      - name: getgroupprocess
        method: GET
        description: Return One MongoDB Process by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-databases
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/databases
      operations:
      - name: listgroupprocessdatabases
        method: GET
        description: Return Available Databases for One MongoDB Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-databases-databaseName
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}
      operations:
      - name: getgroupprocessdatabase
        method: GET
        description: Return One Database for One MongoDB Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: databaseName
          in: path
          type: string
          description: Human-readable label that identifies the database that the specified MongoDB process serves.
          required: true
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-databases-databaseName-measureme
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements
      operations:
      - name: getgroupprocessdatabasemeasurements
        method: GET
        description: Return Measurements for One Database in One MongoDB Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: databaseName
          in: path
          type: string
          description: Human-readable label that identifies the database that the specified MongoDB process serves.
          required: true
        - name: m
          in: query
          type: array
          description: One or more types of measurement to request for this MongoDB process. If omitted, the resource returns
            all measurements. To specify multiple values for `m`, rep
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-disks
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/disks
      operations:
      - name: listgroupprocessdisks
        method: GET
        description: Return Available Disks for One MongoDB Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-disks-partitionName
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}
      operations:
      - name: getgroupprocessdisk
        method: GET
        description: Return Measurements for One Disk
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: partitionName
          in: path
          type: string
          description: Human-readable label of the disk or partition to which the measurements apply.
          required: true
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-disks-partitionName-measurements
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}/measurements
      operations:
      - name: getgroupprocessdiskmeasurements
        method: GET
        description: Return Measurements of One Disk for One MongoDB Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: m
          in: query
          type: array
          description: One or more types of measurement to request for this MongoDB process. If omitted, the resource returns
            all measurements. To specify multiple values for `m`, rep
        - name: partitionName
          in: path
          type: string
          description: Human-readable label of the disk or partition to which the measurements apply.
          required: true
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    - name: api-atlas-v2-groups-groupId-processes-processId-measurements
      path: /api/atlas/v2/groups/{groupId}/processes/{processId}/measurements
      operations:
      - name: getgroupprocessmeasurements
        method: GET
        description: Return Measurements for One MongoDB Process
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: m
          in: query
          type: array
          description: One or more types of measurement to request for this MongoDB process. If omitted, the resource returns
            all measurements. To specify multiple values for `m`, rep
        - name: processId
          in: path
          type: string
          description: Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB
            process. The host must be the hostname, fully qualified doma
          required: true
    authentication:
      type: bearer
      token: '{{env.MONGODB_API_KEY}}'
  exposes:
  - type: rest
    namespace: atlas-monitoring-and-logs-rest
    port: 8080
    description: REST adapter for MongoDB Atlas Administration API — Monitoring and Logs. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/atlas/v2/groups/{groupid}/clusters/{hostname}/logs/logname-gz
      name: api-atlas-v2-groups-groupid-clusters-hostname-logs-logname-gz
      description: REST surface for api-atlas-v2-groups-groupId-clusters-hostName-logs-logName}.gz.
      operations:
      - method: GET
        name: downloadgroupclusterlog
        description: Download Logs for One Cluster Host in One Project
        call: atlas-monitoring-and-logs.downloadgroupclusterlog
        with:
          hostName: rest.hostName
          logName: rest.logName
          endDate: rest.endDate
          startDate: rest.startDate
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/hosts/{processid}/fts/metrics
      name: api-atlas-v2-groups-groupid-hosts-processid-fts-metrics
      description: REST surface for api-atlas-v2-groups-groupId-hosts-processId-fts-metrics.
      operations:
      - method: GET
        name: listgrouphostftsmetrics
        description: Return All Atlas Search Metric Types for One Process
        call: atlas-monitoring-and-logs.listgrouphostftsmetrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/hosts/{processid}/fts/metrics/indexes/{databasename}/{collectionname}/measurements
      name: api-atlas-v2-groups-groupid-hosts-processid-fts-metrics-indexes-databasename-col
      description: REST surface for api-atlas-v2-groups-groupId-hosts-processId-fts-metrics-indexes-databaseName-col.
      operations:
      - method: GET
        name: listgrouphostftsmetricindexmeasurements
        description: Return All Atlas Search Index Metrics for One Namespace
        call: atlas-monitoring-and-logs.listgrouphostftsmetricindexmeasurements
        with:
          metrics: rest.metrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/hosts/{processid}/fts/metrics/indexes/{databasename}/{collectionname}/{indexname}/measurements
      name: api-atlas-v2-groups-groupid-hosts-processid-fts-metrics-indexes-databasename-col
      description: REST surface for api-atlas-v2-groups-groupId-hosts-processId-fts-metrics-indexes-databaseName-col.
      operations:
      - method: GET
        name: getgrouphostftsmetricindexmeasurements
        description: Return Atlas Search Metrics for One Index in One Namespace
        call: atlas-monitoring-and-logs.getgrouphostftsmetricindexmeasurements
        with:
          metrics: rest.metrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/hosts/{processid}/fts/metrics/measurements
      name: api-atlas-v2-groups-groupid-hosts-processid-fts-metrics-measurements
      description: REST surface for api-atlas-v2-groups-groupId-hosts-processId-fts-metrics-measurements.
      operations:
      - method: GET
        name: listgrouphostftsmetricmeasurements
        description: Return Atlas Search Hardware and Status Metrics
        call: atlas-monitoring-and-logs.listgrouphostftsmetricmeasurements
        with:
          metrics: rest.metrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes
      name: api-atlas-v2-groups-groupid-processes
      description: REST surface for api-atlas-v2-groups-groupId-processes.
      operations:
      - method: GET
        name: listgroupprocesses
        description: Return All MongoDB Processes in One Project
        call: atlas-monitoring-and-logs.listgroupprocesses
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}
      name: api-atlas-v2-groups-groupid-processes-processid
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId.
      operations:
      - method: GET
        name: getgroupprocess
        description: Return One MongoDB Process by ID
        call: atlas-monitoring-and-logs.getgroupprocess
        with:
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/databases
      name: api-atlas-v2-groups-groupid-processes-processid-databases
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-databases.
      operations:
      - method: GET
        name: listgroupprocessdatabases
        description: Return Available Databases for One MongoDB Process
        call: atlas-monitoring-and-logs.listgroupprocessdatabases
        with:
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/databases/{databasename}
      name: api-atlas-v2-groups-groupid-processes-processid-databases-databasename
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-databases-databaseName.
      operations:
      - method: GET
        name: getgroupprocessdatabase
        description: Return One Database for One MongoDB Process
        call: atlas-monitoring-and-logs.getgroupprocessdatabase
        with:
          databaseName: rest.databaseName
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/databases/{databasename}/measurements
      name: api-atlas-v2-groups-groupid-processes-processid-databases-databasename-measureme
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-databases-databaseName-measureme.
      operations:
      - method: GET
        name: getgroupprocessdatabasemeasurements
        description: Return Measurements for One Database in One MongoDB Process
        call: atlas-monitoring-and-logs.getgroupprocessdatabasemeasurements
        with:
          databaseName: rest.databaseName
          m: rest.m
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/disks
      name: api-atlas-v2-groups-groupid-processes-processid-disks
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-disks.
      operations:
      - method: GET
        name: listgroupprocessdisks
        description: Return Available Disks for One MongoDB Process
        call: atlas-monitoring-and-logs.listgroupprocessdisks
        with:
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/disks/{partitionname}
      name: api-atlas-v2-groups-groupid-processes-processid-disks-partitionname
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-disks-partitionName.
      operations:
      - method: GET
        name: getgroupprocessdisk
        description: Return Measurements for One Disk
        call: atlas-monitoring-and-logs.getgroupprocessdisk
        with:
          partitionName: rest.partitionName
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/disks/{partitionname}/measurements
      name: api-atlas-v2-groups-groupid-processes-processid-disks-partitionname-measurements
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-disks-partitionName-measurements.
      operations:
      - method: GET
        name: getgroupprocessdiskmeasurements
        description: Return Measurements of One Disk for One MongoDB Process
        call: atlas-monitoring-and-logs.getgroupprocessdiskmeasurements
        with:
          m: rest.m
          partitionName: rest.partitionName
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/atlas/v2/groups/{groupid}/processes/{processid}/measurements
      name: api-atlas-v2-groups-groupid-processes-processid-measurements
      description: REST surface for api-atlas-v2-groups-groupId-processes-processId-measurements.
      operations:
      - method: GET
        name: getgroupprocessmeasurements
        description: Return Measurements for One MongoDB Process
        call: atlas-monitoring-and-logs.getgroupprocessmeasurements
        with:
          m: rest.m
          processId: rest.processId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: atlas-monitoring-and-logs-mcp
    port: 9090
    transport: http
    description: MCP adapter for MongoDB Atlas Administration API — Monitoring and Logs. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: download-logs-one-cluster-host
      description: Download Logs for One Cluster Host in One Project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.downloadgroupclusterlog
      with:
        hostName: tools.hostName
        logName: tools.logName
        endDate: tools.endDate
        startDate: tools.startDate
      outputParameters:
      - type: object
        mapping: $.
    - name: return-all-atlas-search-metric
      description: Return All Atlas Search Metric Types for One Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.listgrouphostftsmetrics
      outputParameters:
      - type: object
        mapping: $.
    - name: return-all-atlas-search-index
      description: Return All Atlas Search Index Metrics for One Namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.listgrouphostftsmetricindexmeasurements
      with:
        metrics: tools.metrics
      outputParameters:
      - type: object
        mapping: $.
    - name: return-atlas-search-metrics-one
      description: Return Atlas Search Metrics for One Index in One Namespace
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgrouphostftsmetricindexmeasurements
      with:
        metrics: tools.metrics
      outputParameters:
      - type: object
        mapping: $.
    - name: return-atlas-search-hardware-and
      description: Return Atlas Search Hardware and Status Metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.listgrouphostftsmetricmeasurements
      with:
        metrics: tools.metrics
      outputParameters:
      - type: object
        mapping: $.
    - name: return-all-mongodb-processes-one
      description: Return All MongoDB Processes in One Project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.listgroupprocesses
      outputParameters:
      - type: object
        mapping: $.
    - name: return-one-mongodb-process-id
      description: Return One MongoDB Process by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgroupprocess
      with:
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-available-databases-one-mongodb
      description: Return Available Databases for One MongoDB Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.listgroupprocessdatabases
      with:
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-one-database-one-mongodb
      description: Return One Database for One MongoDB Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgroupprocessdatabase
      with:
        databaseName: tools.databaseName
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-measurements-one-database-one
      description: Return Measurements for One Database in One MongoDB Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgroupprocessdatabasemeasurements
      with:
        databaseName: tools.databaseName
        m: tools.m
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-available-disks-one-mongodb
      description: Return Available Disks for One MongoDB Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.listgroupprocessdisks
      with:
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-measurements-one-disk
      description: Return Measurements for One Disk
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgroupprocessdisk
      with:
        partitionName: tools.partitionName
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-measurements-one-disk-one
      description: Return Measurements of One Disk for One MongoDB Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgroupprocessdiskmeasurements
      with:
        m: tools.m
        partitionName: tools.partitionName
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.
    - name: return-measurements-one-mongodb-process
      description: Return Measurements for One MongoDB Process
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: atlas-monitoring-and-logs.getgroupprocessmeasurements
      with:
        m: tools.m
        processId: tools.processId
      outputParameters:
      - type: object
        mapping: $.