{"id":50366940,"url":"https://github.com/chainapsis/keplr-wallet-mcp","last_synced_at":"2026-05-30T04:31:09.392Z","repository":{"id":349756414,"uuid":"1193734478","full_name":"chainapsis/keplr-wallet-mcp","owner":"chainapsis","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-15T14:59:58.000Z","size":2138,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-04-15T15:12:17.010Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mcp.keplr.app/docs","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chainapsis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-27T14:25:30.000Z","updated_at":"2026-04-15T15:00:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/chainapsis/keplr-wallet-mcp","commit_stats":null,"previous_names":["chainapsis/keplr-wallet-mcp"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/chainapsis/keplr-wallet-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainapsis%2Fkeplr-wallet-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainapsis%2Fkeplr-wallet-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainapsis%2Fkeplr-wallet-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainapsis%2Fkeplr-wallet-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chainapsis","download_url":"https://codeload.github.com/chainapsis/keplr-wallet-mcp/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainapsis%2Fkeplr-wallet-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33680522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-30T04:31:09.295Z","updated_at":"2026-05-30T04:31:09.354Z","avatar_url":"https://github.com/chainapsis.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Keplr Wallet MCP\n\n\u003e [!WARNING]\n\u003e **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.\n\nYour AI-powered wallet for Cosmos. Send, stake, swap — just ask. Currently supporting 40+ chains via the [Model Context Protocol](https://modelcontextprotocol.io/).\n\nFor setup guides, usage examples, and full tool reference, see the [Docs](https://mcp.keplr.app/docs).\n\n## Architecture\n\nThis is a **pnpm monorepo** with a plugin-based architecture for multi-ecosystem blockchain support.\n\n| Package | Description |\n|---------|-------------|\n| `@keplr-wallet/keplr-wallet-mcp` | Core MCP server with Cosmos built-in + account/chain management |\n| `@keplr-wallet/biometric-darwin` | macOS biometric authentication binary (private) |\n\n## Prerequisites\n\n- **Node.js** \u003e= 22\n- **pnpm** (npm and yarn are not supported)\n\n## Quick Start\n\n### Using the published package\n\n```bash\n# Claude Code\nclaude mcp add --scope user keplr -- npx @keplr-wallet/keplr-wallet-mcp\n\n# Or install directly\nnpm install @keplr-wallet/keplr-wallet-mcp\n```\n\n### Development (from source)\n\n```bash\npnpm install\npnpm build\npnpm start\n```\n\n## Tool Discovery\n\nUse the meta-tools for efficient tool discovery:\n\n1. `search-tools(query: \"send cosmos\")` → Find relevant tools\n2. `describe-tools(names: [\"send-tokens\"])` → Get full parameters\n3. Call the tool directly\n\nOr use the `keplr-guide` prompt for a full workflow guide.\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"keplr\": {\n      \"command\": \"npx\",\n      \"args\": [\"@keplr-wallet/keplr-wallet-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --scope user keplr -- npx @keplr-wallet/keplr-wallet-mcp\n```\n\nFor development, copy the template and fill in your API keys:\n\n```bash\ncp .mcp.json.example .mcp.json\n# Edit .mcp.json with your actual API keys\n```\n\n### Advanced Configuration\n\nFor plugin registration, RPC overrides, or toolset filtering, create a `keplr-mcp.config.ts` in your working directory. See the [Environment Variables](docs/pages/reference/environment.mdx) for details.\n\n## Getting Started\n\nNew to the wallet? Use the onboarding tools to get set up:\n\n```\nonboarding-status    # Check setup progress and get guidance\n/get-started         # Guided onboarding prompt\n```\n\nThe server provides intelligent guidance:\n- **Setup Guide**: When wallet isn't configured, tools return setup options instead of errors\n- **Suggested Actions**: Query results include logical next steps (e.g., \"stake tokens\", \"claim rewards\")\n- **Progress Tracking**: Checklist-based onboarding status\n\n## Account Management\n\nThe server supports multiple accounts stored securely in the OS Keychain:\n\n```\ncreate-account name=\"trading\"              # Create new wallet\nimport-account name=\"main\" mnemonic=\"...\"  # Import existing\nlist-accounts                              # List all accounts\nswitch-account name=\"trading\"             # Switch active account\n```\n\nConfiguration is stored in `~/.keplr-mcp/`.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `KEPLR_MNEMONIC` | No | BIP39 mnemonic (overrides keychain) |\n| `KEPLR_ADAPTERS` | No | Additional adapter packages to load (comma-separated) |\n| `KEPLR_RPC_API_KEY` | No | Keplr RPC API key for premium endpoints (falls back to public RPC if unset) |\n| `KEPLR_TX_TTL_MINUTES` | No | Transaction confirmation token TTL in minutes (default: 5) |\n| `COINGECKO_API_KEY` | No | CoinGecko Pro API key for portfolio price data |\n| `SKIP_API_KEY` | No | Skip Routes API key for IBC channel resolution |\n| `SKIP_API_URL` | No | Skip Routes API endpoint override |\n\n## Supported Chains\n\n**Cosmos:** Cosmos Hub, Osmosis, dYdX, Celestia, Stargaze, Juno, Noble, Stride, Akash, Injective, and 40+ more.\n\n## Tools \u0026 Prompts\n\n67 tools and 20+ prompts across categories: Account Management, Cosmos Query \u0026 Transaction, CosmWasm, Multi-Action, DeFi (Osmosis), Authentication, Keplr Infra, and more.\n\nFor the full tool list and parameters, see the [Tool Reference](https://mcp.keplr.app/docs/reference).\n\n## Security\n\n- Mnemonics are encrypted with AES-256-GCM and stored in `~/.keplr-mcp/vaults/\u003caccount\u003e.enc`. The decryption key is stored in your OS credential store (e.g. macOS Keychain)\n- All transactions (send, delegate, swap, etc.) require explicit confirmation via `confirm-action`\n- Confirmation tokens expire after 5 minutes\n- Use dedicated wallets with limited funds for AI agent usage\n\n### Optional: Two-Factor Authentication\n\nFor 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:\n\n#### Biometric (Touch ID / Face ID)\n```\nauth-setup provider=biometric  # Enable biometric auth\n```\n\n#### TOTP (Google Authenticator)\n```\nauth-setup provider=totp       # Step 1: Generate secret key\n# Add the key to Google Authenticator app\nauth-verify-setup provider=totp code=123456  # Step 2: Verify with 6-digit code\n```\n\nWhen enabled, you'll need to authenticate before performing protected actions.\n\nTOTP secrets are stored in your OS credential store (e.g. macOS Keychain), not in the config file.\n\n**Supported authenticator apps:** Google Authenticator, Authy, Microsoft Authenticator, 1Password, and any RFC 6238 compatible app.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainapsis%2Fkeplr-wallet-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchainapsis%2Fkeplr-wallet-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainapsis%2Fkeplr-wallet-mcp/lists"}