# MongoDB Atlas

Manage MongoDB Atlas: projects, clusters, database users, network access, backups. Exposes **35 actions** covering the API surface an agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `mongodbatlas_organizations_list` | List organizations - GET /orgs. |
| `mongodbatlas_organization_get` | Get one organization - GET /orgs/{id}. |
| `mongodbatlas_organization_create` | Create an organization - POST /orgs. |
| `mongodbatlas_organization_update` | Update an organization - PATCH /orgs/{id}. |
| `mongodbatlas_organization_delete` | Delete an organization - DELETE /orgs/{id}. |
| `mongodbatlas_projects_list` | List projects - GET /groups. |
| `mongodbatlas_project_get` | Get one project - GET /groups/{id}. |
| `mongodbatlas_project_create` | Create a project - POST /groups. |
| `mongodbatlas_project_update` | Update a project - PATCH /groups/{id}. |
| `mongodbatlas_project_delete` | Delete a project - DELETE /groups/{id}. |
| `mongodbatlas_clusters_list` | List clusters - GET /groups/{project_id}/clusters. |
| `mongodbatlas_cluster_get` | Get one cluster - GET /groups/{project_id}/clusters/{cluster_name}. |
| `mongodbatlas_cluster_create` | Create a cluster - POST /groups/{project_id}/clusters. |
| `mongodbatlas_cluster_update` | Update a cluster - PATCH /groups/{project_id}/clusters/{cluster_name}. |
| `mongodbatlas_cluster_delete` | Delete a cluster - DELETE /groups/{project_id}/clusters/{cluster_name}. |
| `mongodbatlas_cluster_pause` | Pause a cluster - POST /groups/{project_id}/clusters/{cluster_name}/pause. |
| `mongodbatlas_cluster_resume` | Resume a paused cluster - POST /groups/{project_id}/clusters/{cluster_name}/resume. |
| `mongodbatlas_database_users_list` | List database users - GET /groups/{project_id}/databaseUsers. |
| `mongodbatlas_database_user_get` | Get one database user - GET /groups/{project_id}/databaseUsers/{username}. |
| `mongodbatlas_database_user_create` | Create a database user - POST /groups/{project_id}/databaseUsers. |
| `mongodbatlas_database_user_update` | Update a database user - PATCH /groups/{project_id}/databaseUsers/admin/{username}. |
| `mongodbatlas_database_user_delete` | Delete a database user - DELETE /groups/{project_id}/databaseUsers/admin/{username}. |
| `mongodbatlas_network_access_list` | List IP access list entries - GET /groups/{project_id}/accessList. |
| `mongodbatlas_network_access_get` | Get one IP access list entry - GET /groups/{project_id}/accessList/{ip_address}. |
| `mongodbatlas_network_access_create` | Add an IP to the access list - POST /groups/{project_id}/accessList. |
| `mongodbatlas_network_access_delete` | Remove an IP from the access list - DELETE /groups/{project_id}/accessList/{ip_address}. |
| `mongodbatlas_backups_list` | List backups for a cluster - GET /groups/{project_id}/clusters/{cluster_name}/backups. |
| `mongodbatlas_backup_get` | Get one backup - GET /groups/{project_id}/clusters/{cluster_name}/backups/{backup_id}. |
| `mongodbatlas_restore_jobs_list` | List restore jobs for a cluster - GET /groups/{project_id}/clusters/{cluster_name}/restoreJobs. |
| `mongodbatlas_alerts_list` | List alerts - GET /groups/{project_id}/alerts. |
| `mongodbatlas_alert_get` | Get one alert - GET /groups/{project_id}/alerts/{alert_id}. |
| `mongodbatlas_alert_acknowledge` | Acknowledge an alert - PATCH /groups/{project_id}/alerts/{alert_id}. |
| `mongodbatlas_processes_list` | List processes (hosts) in a project - GET /groups/{group_id}/processes. |
| `mongodbatlas_process_get` | Get one process info - GET /groups/{group_id}/processes/{host_name}. |
| `mongodbatlas_metrics_get` | Get metrics for a process - GET /groups/{group_id}/processes/{host_name}/measurements. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`MONGODBATLAS_PUBLIC_KEY`** - Atlas - Access Manager - API Keys - Public Key. (https://cloud.mongodb.com/)
- **`MONGODBATLAS_PRIVATE_KEY`** - Private key shown when you create the API key.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `MONGODBATLAS_PUBLIC_KEY` | Atlas - Access Manager - API Keys - Public Key. |
| `MONGODBATLAS_PRIVATE_KEY` | Private key shown when you create the API key. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope; regenerate it.
- **`429 Too Many Requests`** - provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [MongoDB Atlas API documentation](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/)