diff --git a/docs/cloud/agent-server.mdx b/docs/cloud/agent-server.mdx
index 9dd774480..43439091f 100644
--- a/docs/cloud/agent-server.mdx
+++ b/docs/cloud/agent-server.mdx
@@ -147,11 +147,6 @@ uv run mcp-agent serve --app my_agent:app --transport sse
```
#### Deploying to **mcp-agent cloud**
-Update your secrets
-```yaml mcp_agent.secrets.yaml
-openai:
- api_key: !developer_secret
-```
```bash
uv run mcp-agent login
diff --git a/docs/cloud/getting-started.mdx b/docs/cloud/getting-started.mdx
index 22b025afd..fcc4062d2 100644
--- a/docs/cloud/getting-started.mdx
+++ b/docs/cloud/getting-started.mdx
@@ -60,18 +60,6 @@ Before you begin, make sure you have:
openai:
default_model: gpt-4o
```
-
-
- Swap your api_key with !developer_secret to mark what keys will be saved as secrets within mcp-agent cloud.
-
-
- ```yaml mcp_agent.secrets.yaml
- openai:
- api_key: !developer_secret
- anthropic:
- api_key: !developer_secret
- # Other secrets as needed
- ```
@@ -83,7 +71,7 @@ Before you begin, make sure you have:
The deployment process will:
1. Check for existing app with this name or create a new one
- 2. Process your secrets file (transforming `!developer_secret` tags to secure handles)
+ 2. Process your secrets file
3. Bundle and upload your code
4. Deploy to MCP Agent Cloud's managed infrastructure
@@ -191,11 +179,6 @@ mcp:
openai:
default_model: gpt-4o
```
-
-```yaml mcp_agent.secrets.yaml
-openai:
- api_key: !developer_secret
-```
### Deploy to Cloud
@@ -335,22 +318,8 @@ MCP_API_KEY="your-key" mcp-agent deploy my-agent
### Secrets Management
MCP Agent Cloud securely handles secrets through the `mcp_agent.secrets.yaml` file:
-
-```yaml mcp_agent.secrets.yaml
-openai:
- api_key: !developer_secret # Will be stored securely
-
-anthropic:
- api_key: !developer_secret
-
-custom_service:
- token: !developer_secret
-```
-
-During deployment, secrets marked with `!developer_secret` are:
-1. Prompted for if not already stored
-2. Securely uploaded to MCP Agent Cloud's vault
-3. Referenced by handle in the deployed configuration
+1. During `mcp-agent deploy`, you will be prompted through the secrets management flow
+2. Secrets are safely secured in MCP Agent Cloud
## Testing with MCP Inspector
diff --git a/docs/cloud/overview.mdx b/docs/cloud/overview.mdx
index de6e2bcf1..8c31c3b1a 100644
--- a/docs/cloud/overview.mdx
+++ b/docs/cloud/overview.mdx
@@ -39,13 +39,6 @@ async def research(query) -> str:
# Tool: "research"
```
-4. Mark your secrets that you'd like to safely secure for deployment
-
-```yaml mcp_agent.secrets.yaml
-openai:
- api_key: !developer_secret
-```
-
## Deploying your mcp-agent app
1. Login into mcp-agent cloud to get your `api key`
@@ -60,6 +53,8 @@ uv run mcp-agent login
uv run mcp-agent deploy my-first-agent
```
+During the deployment flow, you will be guided through how you'd like your secrets to be managed.
+
## Connect to your deployed mcp-agent server
### Claude Desktop integration
diff --git a/docs/configuration.mdx b/docs/configuration.mdx
index 213d7ebf2..9a15963ce 100644
--- a/docs/configuration.mdx
+++ b/docs/configuration.mdx
@@ -690,17 +690,6 @@ Keep sensitive configuration in separate secrets files:
api_key: "${OPENAI_API_KEY}"
```
-
-
- For mcp-agent cloud deployments, use mcp-agent cloud's secret management:
-
- ```yaml
- openai:
- api_key: !developer_secret
- ```
-
- Mark which secrets you, as the developer, want to keep safe and secure.s
-
### Subagent Configuration
diff --git a/examples/basic/mcp_basic_agent/README.md b/examples/basic/mcp_basic_agent/README.md
index ed703ed46..a2c32e1e1 100644
--- a/examples/basic/mcp_basic_agent/README.md
+++ b/examples/basic/mcp_basic_agent/README.md
@@ -96,22 +96,14 @@ uv run main.py
uv run mcp-agent login
```
-### `b.` Update your `mcp_agent.secrets.yaml` to mark your developer secrets (keys)
-
-```yaml
-openai:
- api_key: !developer_secret
-anthropic:
- api_key: !developer_secret
-# Other secrets as needed
-```
-
-### `c.` Deploy your agent with a single command
+### `b.` Deploy your agent with a single command
```bash
uv run mcp-agent deploy my-first-agent
```
-### `d.` Connect to your deployed agent as an MCP server through any MCP client
+During deployment, you can select how you would like your secrets managed.
+
+### `c.` Connect to your deployed agent as an MCP server through any MCP client
#### Claude Desktop Integration
diff --git a/examples/basic/mcp_model_selector/README.md b/examples/basic/mcp_model_selector/README.md
index 1d763634b..a8694d99c 100644
--- a/examples/basic/mcp_model_selector/README.md
+++ b/examples/basic/mcp_model_selector/README.md
@@ -72,22 +72,14 @@ uv run interactive.py
uv run mcp-agent login
```
-### `b.` Update your `mcp_agent.secrets.yaml` to mark your developer secrets (keys)
-
-```yaml
-openai:
- api_key: !developer_secret
-anthropic:
- api_key: !developer_secret
-# Other secrets as needed
-```
-
-### `c.` Deploy your agent with a single command
+### `b.` Deploy your agent with a single command
```bash
uv run mcp-agent deploy model-selector-server
```
-### `d.` Connect to your deployed agent as an MCP server through any MCP client
+During deployment, you can select how you would like your secrets managed.
+
+### `c.` Connect to your deployed agent as an MCP server through any MCP client
#### Claude Desktop Integration
diff --git a/examples/mcp_agent_server/asyncio/README.md b/examples/mcp_agent_server/asyncio/README.md
index bdfaebadf..9d8b030a3 100644
--- a/examples/mcp_agent_server/asyncio/README.md
+++ b/examples/mcp_agent_server/asyncio/README.md
@@ -155,25 +155,14 @@ uv run client.py --custom-fastmcp-settings
### [Beta] Deploying to mcp-agent cloud
You can deploy your MCP-Agent app as a hosted mcp-agent app in the Cloud.
-
-1. Update the *mcp_agent.secrets.yaml* file specifying deployed secrets:
-
-```
-openai:
- api_key: !developer_secret
-
-anthropic:
- api_key: !developer_secret
-```
-
-2. In your terminal, authenticate into mcp-agent cloud by running:
+1. In your terminal, authenticate into mcp-agent cloud by running:
```
uv run mcp-agent login
```
-3. You will be redirected to the login page, create an mcp-agent cloud account through Google or Github
+2. You will be redirected to the login page, create an mcp-agent cloud account through Google or Github
-4. Set up your mcp-agent cloud API Key and copy & paste it into your terminal
+3. Set up your mcp-agent cloud API Key and copy & paste it into your terminal
```
andrew_lm@Mac sdk-cloud % uv run mcp-agent login
@@ -181,12 +170,12 @@ INFO: Directing to MCP Agent Cloud API login...
Please enter your API key 🔑:
```
-5. In your terminal, deploy the MCP app:
+4. In your terminal, deploy the MCP app:
```
uv run mcp-agent deploy mcp_agent_server -c /absolute/path/to/your/project
```
-6. In the terminal, ou will then be prompted to specify your OpenAI and/or Anthropic keys:
+5. In the terminal, you will then be prompted to specify your OpenAI and/or Anthropic keys:
Once the deployment is successful, you should see the following:
```
diff --git a/examples/usecases/mcp_github_to_slack_agent/README.md b/examples/usecases/mcp_github_to_slack_agent/README.md
index 880771bbe..dc040b8cb 100644
--- a/examples/usecases/mcp_github_to_slack_agent/README.md
+++ b/examples/usecases/mcp_github_to_slack_agent/README.md
@@ -75,32 +75,15 @@ uv run main.py --owner --repo --channel