You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> **Beta Notice:** Keplr Wallet MCP is in beta and may contain bugs or unexpected behavior. By using this software, you acknowledge that you do so at your own risk. The developers are not liable for any loss of funds or damages arising from the use of this software.
5
5
6
-
AI agents can interact with Cosmos ecosystem chains via the [Model Context Protocol](https://modelcontextprotocol.io/).
6
+
Your AI-powered wallet for Cosmos. Send, stake, swap — just ask. Currently supporting 40+ chains via the [Model Context Protocol](https://modelcontextprotocol.io/).
7
+
8
+
For setup guides, usage examples, and full tool reference, see the [Docs](https://mcp.keplr.app/docs).
7
9
8
10
## Architecture
9
11
@@ -12,6 +14,7 @@ This is a **pnpm monorepo** with a plugin-based architecture for multi-ecosystem
12
14
| Package | Description |
13
15
|---------|-------------|
14
16
|`@keplr-wallet/keplr-wallet-mcp`| Core MCP server with Cosmos built-in + account/chain management |
-`/keplr-guide` — Guide for discovering and using tools via meta-tools
131
+
## Tools & Prompts
132
+
133
+
67 tools and 20+ prompts across categories: Account Management, Cosmos Query & Transaction, CosmWasm, Multi-Action, DeFi (Osmosis), Authentication, Keplr Infra, and more.
134
+
135
+
For the full tool list and parameters, see the [Tool Reference](https://mcp.keplr.app/docs/reference).
238
136
239
137
## Security
240
138
241
-
- Mnemonics are stored in the OS Keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)
242
-
- All state-changing operations require explicit confirmation via `confirm-action`
139
+
- Mnemonics are encrypted with AES-256-GCM and stored in `~/.keplr-mcp/vaults/<account>.enc`. The decryption key is stored in your OS credential store (e.g. macOS Keychain)
140
+
- All transactions (send, delegate, swap, etc.) require explicit confirmation via `confirm-action`
243
141
- Confirmation tokens expire after 5 minutes
244
142
- Use dedicated wallets with limited funds for AI agent usage
245
143
246
144
### Optional: Two-Factor Authentication
247
145
248
-
For additional security, you can enable authentication for destructive actions (e.g., account deletion). Two methods are available:
146
+
For additional security, you can enable authentication for destructive actions (account deletion, mnemonic export). Authentication is handled separately from transaction confirmation — it applies at the tool layer, not via `confirm-action`. Two methods are available:
Copy file name to clipboardExpand all lines: docs/pages/getting-started/create-your-first-wallet.mdx
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ Set up your wallet in seconds — just ask your AI assistant.
8
8
9
9
> "Create a new Keplr wallet called my-wallet"
10
10
11
-
**2.** Claude will generate a wallet and store it securely in your OS credential store (e.g. macOS Keychain). You'll see your wallet addresses for Cosmos chains.
11
+
**2.** Claude will generate a wallet and store it securely — the mnemonic is encrypted and saved locally, with the decryption key in your OS credential store (e.g. macOS Keychain). You'll see your wallet addresses for Cosmos chains.
12
12
13
13
**3.** Verify it worked:
14
14
@@ -28,7 +28,7 @@ Your new wallet should appear as the active account.
28
28
This will leave your mnemonic as plain text in the conversation history. To avoid exposure, use the `KEPLR_MNEMONIC` environment variable instead. See [Environment Variables](/reference/environment#keplr_mnemonic) for details.
29
29
:::
30
30
31
-
**2.** Claude will import the wallet and store it securely in your OS credential store (e.g. macOS Keychain). You'll see your wallet addresses for Cosmos chains.
31
+
**2.** Claude will import the wallet and store it securely — the mnemonic is encrypted and saved locally, with the decryption key in your OS credential store (e.g. macOS Keychain). You'll see your wallet addresses for Cosmos chains.
Copy file name to clipboardExpand all lines: docs/pages/index.mdx
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Keplr Wallet MCP
2
2
3
-
Your AI-powered wallet. Send, stake, swap - just ask. Currently supporting 50+ Cosmos chains.
3
+
Your AI-powered wallet. Send, stake, swap - just ask. Currently supporting 40+ Cosmos chains.
4
4
5
5
:::info[Beta Notice]
6
6
Keplr Wallet MCP is in beta and may contain bugs or unexpected behavior. By using this software, you acknowledge that you do so at your own risk. The developers are not liable for any loss of funds or damages arising from the use of this software.
@@ -10,14 +10,14 @@ Keplr Wallet MCP is in beta and may contain bugs or unexpected behavior. By usin
10
10
11
11
Keplr Wallet MCP brings your Cosmos wallet into AI assistants like Claude. Describe what you want in everyday language, and the AI executes it for you.
12
12
13
-
-**50+ Cosmos chains**: Cosmos Hub, Osmosis, Celestia, and more
13
+
-**40+ Cosmos chains**: Cosmos Hub, Osmosis, Celestia, and more
14
14
-**Token swaps**: Osmosis DEX
15
15
16
16
## Key Features
17
17
18
18
### Multi-Chain Support
19
19
20
-
50+ Cosmos chains supported out of the box.
20
+
40+ Cosmos chains supported out of the box.
21
21
22
22
<details>
23
23
<summary>View all supported chains</summary>
@@ -35,7 +35,7 @@ Ask your AI assistant things like:
35
35
36
36
### Wallet Security
37
37
38
-
Your wallet is protected by a **24-word recovery phrase** (mnemonic). The recovery phrase is encrypted and stored in your OS credential store (e.g. macOS Keychain).
38
+
Your wallet is protected by a **24-word recovery phrase** (mnemonic). The recovery phrase is encrypted with AES-256-GCM and stored locally. The decryption key is stored in your OS credential store (e.g. macOS Keychain).
Copy file name to clipboardExpand all lines: docs/pages/reference/tools/accounts.mdx
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,7 +58,7 @@ None required.
58
58
"tool": "create-account"
59
59
},
60
60
"setupOptions": [
61
-
{ "tool": "create-account", "description": "Generate a new wallet with a fresh mnemonic phrase", "security": "Keys stored in OS Keychain", "ecosystems": ["Cosmos"] },
61
+
{ "tool": "create-account", "description": "Generate a new wallet with a fresh mnemonic phrase", "security": "Encrypted locally, decryption key in OS Keychain", "ecosystems": ["Cosmos"] },
62
62
{ "tool": "import-account", "description": "Import existing wallet with your mnemonic phrase", "security": "⚠️ Mnemonic visible in chat history - use with caution", "ecosystems": ["Cosmos"] }
63
63
]
64
64
}
@@ -92,7 +92,7 @@ Response: {
92
92
"message": "Next step: Create your first wallet to get started",
93
93
"nextAction": { "tool": "create-account" },
94
94
"setupOptions": [
95
-
{ "tool": "create-account", "description": "Generate a new wallet with a fresh mnemonic phrase", "security": "Keys stored in OS Keychain", "ecosystems": ["Cosmos"] }
95
+
{ "tool": "create-account", "description": "Generate a new wallet with a fresh mnemonic phrase", "security": "Encrypted locally, decryption key in OS Keychain", "ecosystems": ["Cosmos"] }
96
96
]
97
97
}
98
98
```
@@ -126,7 +126,7 @@ Generate a new wallet with a BIP39 mnemonic phrase.
126
126
"addresses": { "Cosmos": "cosmos1..." },
127
127
"warning": "⚠️ This mnemonic was transmitted through your AI provider's servers. Store it in a secure location immediately and consider deleting this conversation.",
128
128
"security": {
129
-
"storage": "OS Keychain (secure)",
129
+
"storage": "Encrypted locally (AES-256-GCM), decryption key in OS Keychain",
130
130
"backupRecommendation": "Consider backing up your recovery phrase in a secure location."
131
131
},
132
132
"nextSteps": [
@@ -158,7 +158,7 @@ Response: {
158
158
"addresses": { "Cosmos": "cosmos1..." },
159
159
"warning": "⚠️ This mnemonic was transmitted through your AI provider's servers. ...",
160
160
"security": {
161
-
"storage": "OS Keychain (secure)",
161
+
"storage": "Encrypted locally (AES-256-GCM), decryption key in OS Keychain",
162
162
"backupRecommendation": "Consider backing up your recovery phrase in a secure location."
163
163
},
164
164
"nextSteps": [
@@ -221,8 +221,8 @@ If declined, the response includes alternatives:
221
221
},
222
222
"addresses": { "Cosmos": "cosmos1..." },
223
223
"security": {
224
-
"storage": "OS Keychain (secure)",
225
-
"note": "Your recovery phrase is now stored securely in your system keychain.",
224
+
"storage": "Encrypted locally (AES-256-GCM), decryption key in OS Keychain",
225
+
"note": "Your recovery phrase is encrypted and stored locally. The decryption key is in your system keychain.",
226
226
"warnings": [
227
227
"🚨 IMPORTANT: Your mnemonic was provided as a tool parameter and is visible in this conversation",
228
228
"🔒 Consider clearing chat history if this is a high-value wallet",
0 commit comments