# Doppler — how to use (mcp.ai)

Connect your Doppler account and use 62 tools for developer tools straight from your AI agent. Connect with your own API key. Doppler is a secrets management platform that helps developers organize and sync environment variables across teams and infrastructure.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_doppler?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `doppler_activity_logs_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/doppler`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/doppler/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/doppler/activity/logs/list` — List workplace activity logs with pagination support. Retrieves a paginated list of activity logs showing actions performed by users and bots in your Doppler workplace, such as creating projects, modi
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/doppler/activity/logs/retrieve` — Retrieve detailed information about a specific activity log entry. Activity logs track all actions performed in the Doppler workplace including project creation, secret modifications, user actions, et
  - body: { id: string }
- `POST https://api.mcp.ai/api/doppler/add/webhook` — Tool to create a new webhook for a Doppler project. Use when you need to configure webhook notifications for secret changes or other events in a project. The webhook URL must use HTTPS. Optionally con
  - body: { url: string, secret?: string, payload?: string, project?: string, authentication?: object, enable_configs?: string[] }
- `POST https://api.mcp.ai/api/doppler/auth/me` — Tool to retrieve information about the authenticated user or token. Use when you need to verify authentication status or get details about the current token's workplace and permissions.
- `POST https://api.mcp.ai/api/doppler/config/logs/get` — Tool to retrieve a specific config log from Doppler. Use when you need to view details about a particular configuration change or event.
  - body: { log: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/config/logs/list` — Tool to retrieve configuration change logs for a specific config in a project. Use when you need to view the history of configuration changes, track who made changes, or identify rollback actions.
  - body: { page?: integer, config: string, project: string, per_page?: integer }
- `POST https://api.mcp.ai/api/doppler/config/logs/rollback` — Tool to rollback a config to a selected log version. Use when needing to undo a specific change by its log ID, after confirming project, config, and log ID.
  - body: { log: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/configs/clone` — Tool to clone a branch config including all its secrets. Use after confirming the source config details.
  - body: { name: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/configs/create` — Tool to create a branch config. Use when you need to programmatically establish a new branch-based configuration for a specified project and environment. The config name MUST start with the environmen
  - body: { name: string, project: string, environment: string }
- `POST https://api.mcp.ai/api/doppler/configs/delete` — Tool to delete a config permanently. Use when you need to remove a config that is no longer needed.
  - body: { config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/configs/get` — Tool to retrieve a specific Doppler config by project and config name. Use when you need to get configuration details for a specific project environment.
  - body: { config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/configs/list` — Tool to list configurations from a Doppler project. Use when you need to retrieve all configs or filter by environment. Supports pagination for large result sets.
  - body: { page?: integer, project: string, per_page?: integer, environment?: string }
- `POST https://api.mcp.ai/api/doppler/configs/lock` — Lock a Doppler config to prevent it from being renamed or deleted. Locking provides protection against accidental modifications to critical configurations. Use this after confirming the correct projec
  - body: { config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/configs/unlock` — Tool to unlock a config. Use when you need to allow renaming or deletion of a previously locked config.
  - body: { config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/configs/update` — Rename an existing Doppler config within a project. This action modifies the config's name while preserving all secrets and settings. Before using this action: 1. Use DOPPLER_PROJECTS_LIST to get the 
  - body: { name: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/create/encrypted` — Create a Doppler Share link for an end-to-end encrypted secret. This tool generates a secure, shareable link where the secret is encrypted client-side and decrypted in the recipient's browser, ensurin
  - body: { expire_days?: integer, expire_views?: integer, encryption_kdf: string, hashed_password: string, encrypted_secret: string, encryption_salt_rounds: integer }
- `POST https://api.mcp.ai/api/doppler/create/plain` — Tool to generate a Doppler Share link by sending a plain text secret. Use when you need to securely share secrets with expiration controls. The secret is not stored in plain text by Doppler; the recei
  - body: { secret: string, expire_days?: integer, expire_views?: integer }
- `POST https://api.mcp.ai/api/doppler/create/service/token` — Tool to create a new service token for a Doppler config. Use when you need to generate API credentials for services to access secrets programmatically. The token grants either read-only or read/write 
  - body: { name: string, access?: string, config: string, project: string, expire_at?: string }
- `POST https://api.mcp.ai/api/doppler/delete/service/token` — Tool to delete an existing service token from a Doppler config. Use when you need to revoke or remove a service token that is no longer needed.
  - body: { slug?: string, token?: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/delete/webhook` — Tool to delete an existing webhook. Use when you need to permanently remove a webhook from a project.
  - body: { slug: string, project?: string }
- `POST https://api.mcp.ai/api/doppler/disable/webhook` — Tool to disable an existing Doppler webhook. Use when you need to temporarily stop a webhook from receiving notifications without deleting it.
  - body: { slug: string, project?: string }
- `POST https://api.mcp.ai/api/doppler/dynamic/secrets/revoke/lease` — Revoke a dynamic secret lease immediately before its TTL expires. Use this tool when you need to terminate access to a dynamic secret (e.g., AWS IAM user, database credentials) by invalidating its act
  - body: { lease: string, config: string, project?: string, dynamic_secret: string }
- `POST https://api.mcp.ai/api/doppler/enable/webhook` — Tool to enable a previously disabled webhook. Use when you need to reactivate a webhook that was temporarily disabled.
  - body: { slug: string, project?: string }
- `POST https://api.mcp.ai/api/doppler/environments/create` — Create a new environment in a Doppler project. Environments (like dev, staging, prod) organize different configurations within a project. Use this when you need to set up a new deployment environment 
  - body: { name: string, slug: string, project: string }
- `POST https://api.mcp.ai/api/doppler/environments/delete` — Tool to delete an environment. Use when you need to remove an environment from a project after confirming it's no longer in use.
  - body: { project: string, environment: string }
- `POST https://api.mcp.ai/api/doppler/environments/get` — Retrieves detailed metadata for a specific Doppler environment within a project. Use this to get information about an environment including its name, creation date, first fetch timestamp, and personal
  - body: { project: string, environment: string }
- `POST https://api.mcp.ai/api/doppler/environments/list` — Tool to list all environments in a Doppler project. Use when you need to retrieve the environments available in a specific project.
  - body: { project: string }
- `POST https://api.mcp.ai/api/doppler/environments/rename` — Rename an environment's display name within a Doppler project. This updates only the human-readable name; the environment slug remains unchanged. Use this when you need to update how an environment ap
  - body: { name: string, project: string, environment: string }
- `POST https://api.mcp.ai/api/doppler/get/webhook` — Tool to retrieve an existing webhook by its slug. Use when you need to get webhook details including URL, authentication settings, enabled status, and payload configuration.
  - body: { slug: string, project: string }
- `POST https://api.mcp.ai/api/doppler/get/workplace/user` — Tool to retrieve a specific workplace user by their workplace_user id. Use when you need to get detailed information about a workplace user including their access level, creation date, and nested user
  - body: { slug: string }
- `POST https://api.mcp.ai/api/doppler/groups/delete/member` — Remove a member from a Doppler group. This permanently removes the specified member (workplace_user, group, invite, or service_account) from the group. Requires valid group and member slugs. Returns 2
  - body: { slug: string, type: string, member_slug: string }
- `POST https://api.mcp.ai/api/doppler/integrations/list` — Tool to retrieve all existing integrations in Doppler. Use when you need to list all configured integrations.
- `POST https://api.mcp.ai/api/doppler/invites/list` — Tool to list open workplace invites. Use when you need to retrieve all pending invitations for the current Doppler workplace after authenticating.
- `POST https://api.mcp.ai/api/doppler/list/change/requests` — List existing change requests in the Doppler workplace. Use this tool to retrieve all change requests and view their current status. Change requests are a workflow-driven mechanism for proposing addit
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/doppler/list/project/members` — Tool to list all members of a Doppler project including users, groups, service accounts, and invites. Use when you need to retrieve all members with their roles and environment access permissions for 
  - body: { page?: integer, project: string, per_page?: integer }
- `POST https://api.mcp.ai/api/doppler/list/service/tokens` — Tool to list all service tokens for a specific Doppler config. Use when you need to view existing API credentials and their access levels.
  - body: { config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/list/users` — Tool to list all users in the Doppler workplace. Use when you need to retrieve user information, check user access levels, or filter users by email address.
  - body: { page?: integer, email?: string }
- `POST https://api.mcp.ai/api/doppler/list/webhooks` — Tool to list all webhooks configured for a Doppler project. Use when you need to retrieve all webhooks or check webhook configurations for a specific project.
  - body: { project: string }
- `POST https://api.mcp.ai/api/doppler/project/members/delete` — Tool to remove a member from a project. Use after confirming project slug, member type, and slug.
  - body: { slug: string, type: string, project: string }
- `POST https://api.mcp.ai/api/doppler/project/members/get` — Retrieve a specific project member's details including their role and environment access permissions. Use this when you need to check a specific user's, group's, service account's, or invite's members
  - body: { slug: string, type: string, project: string }
- `POST https://api.mcp.ai/api/doppler/project/permissions/list` — List all available project-level permissions in Doppler. Returns permission identifiers (slugs) that can be assigned to project roles when creating or updating custom roles. Use this to discover what 
- `POST https://api.mcp.ai/api/doppler/project/roles/get` — Retrieve detailed information about a specific project role in Doppler, including its permissions, display name, identifier, creation timestamp, and whether it's a custom or built-in role. Use this to
  - body: { role: string }
- `POST https://api.mcp.ai/api/doppler/project/roles/list` — Tool to list all available project roles in Doppler. Use when you need to retrieve all roles for permission management or to see what roles are available.
- `POST https://api.mcp.ai/api/doppler/projects/create` — Tool to create a project. Use when you need to programmatically initialize a new Doppler project after authentication.
  - body: { name: string, description?: string }
- `POST https://api.mcp.ai/api/doppler/projects/delete` — Tool to delete a project permanently. Use after confirming irreversible removal.
  - body: { project: string }
- `POST https://api.mcp.ai/api/doppler/projects/get` — Tool to retrieve details of a specific Doppler project by its identifier. Use when you need to get project metadata including ID, slug, name, description, and creation timestamp.
  - body: { project: string }
- `POST https://api.mcp.ai/api/doppler/projects/list` — Tool to list all Doppler projects in your workspace. Use when you need to retrieve available projects for configuration management or to get project details.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/doppler/secrets/delete` — Tool to delete a secret from a Doppler config. Use when you need to permanently remove a secret from a specific project and config.
  - body: { name: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/secrets/download` — Tool to download secrets from a Doppler config in various formats. Use when you need to retrieve all secrets or a subset of secrets from a specific project and config. Supports multiple output formats
  - body: { config?: string, format?: string, project?: string, secrets?: string, name_transformer?: string, dynamic_secrets_ttl_sec?: integer, include_dynamic_secrets?: boolean }
- `POST https://api.mcp.ai/api/doppler/secrets/get` — Tool to retrieve a specific secret from a Doppler project config. Use when you need to get the value of a specific secret including its raw and computed values.
  - body: { name: string, config: string, project: string }
- `POST https://api.mcp.ai/api/doppler/secrets/list` — Tool to list all secrets for a specific Doppler config within a project. Use when you need to retrieve secret values and metadata. Returns both raw and computed values for each secret, along with visi
  - body: { config: string, project: string, dynamic_secrets_ttl_sec?: integer, include_dynamic_secrets?: boolean, include_managed_secrets?: boolean }
- `POST https://api.mcp.ai/api/doppler/secrets/names` — Tool to retrieve the list of secret names from a specific Doppler config. Use when you need to list available secret names without their values.
  - body: { config: string, project: string, include_dynamic_secrets?: boolean, include_managed_secrets?: boolean }
- `POST https://api.mcp.ai/api/doppler/secrets/update` — Tool to update secrets in a Doppler config. Use when you need to create or update secret values in a specific project and config.
  - body: { config: string, project: string, secrets?: object }
- `POST https://api.mcp.ai/api/doppler/secrets/update/note` — Tool to update a note for a secret in Doppler. Use when you need to add or modify documentation for a specific secret. Notes are stored at the project level and apply across all environments, though a
  - body: { note: string, config: string, secret: string, project: string }
- `POST https://api.mcp.ai/api/doppler/update/project` — Tool to update an existing Doppler project's name or description. Use when you need to rename a project or modify its description after it has been created.
  - body: { name: string, project: string, description?: string }
- `POST https://api.mcp.ai/api/doppler/update/secret/note` — DEPRECATED: Use DopplerSecretsUpdateNote instead. Tool to set or update a note for a secret in Doppler. Use when you need to add or modify documentation for a specific secret. Notes are stored at the 
  - body: { note: string, config: string, secret: string, project: string }
- `POST https://api.mcp.ai/api/doppler/update/webhook` — Tool to update an existing webhook configuration in Doppler. Use when you need to modify webhook URL, authentication, enabled configs, or other webhook settings.
  - body: { url?: string, slug: string, secret?: string, payload?: string, project?: string, enableConfigs?: string[], authentication?: object, disableConfigs?: string[] }
- `POST https://api.mcp.ai/api/doppler/update/workplace` — Tool to update workplace settings in Doppler. Use when you need to modify workplace name, billing email, or security email. At least one field must be provided to update.
  - body: { name?: string, billing_email?: string, security_email?: string }
- `POST https://api.mcp.ai/api/doppler/workplace/get` — Tool to retrieve workplace information from Doppler. Use when you need to get workplace details including ID, name, billing email, and security email.
- `POST https://api.mcp.ai/api/doppler/workplace/roles/get` — Tool to retrieve workplace role information from Doppler. Use when you need to get details about a specific role including its permissions and metadata.
  - body: { role: string }
- `POST https://api.mcp.ai/api/doppler/workplace/roles/list` — Tool to list all workplace roles in your Doppler workspace. Use when you need to retrieve available workplace roles for user management or permission configuration.
- `POST https://api.mcp.ai/api/doppler/workplace/roles/list/permissions` — Retrieves all available workplace permissions in Doppler. This action returns a comprehensive list of permission identifiers that can be assigned to workplace roles. Workplace permissions control acce

## Example prompts
- "What can I do in Doppler?"
- "Show me a summary of my Doppler account"

## More
- Page: https://mcp.ai/doppler
- Agent spec (llms.txt): https://mcp.ai/doppler/llms.txt
- Postman collection: https://mcp.ai/doppler/postman.json