@keyban/agent-wallet-mcp 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026 Keyban
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,86 @@
+# @keyban/agent-wallet-mcp
+
+Give an AI agent its own blockchain wallet: balances, USDC transfers and
+[x402](https://x402.org) payments, under a spending policy the agent cannot
+change.
+
+Registry name: `io.keyban.prod.mcp/agent-wallet`.
+
+The server runs locally over stdio, next to your MCP client. It holds one share
+of a FROST threshold key in your OS keyring; Keyban holds the other. No single
+side can move funds alone, and the model never sees either share or your API
+key.
+
+## Install
+
+```bash
+npx -y @keyban/agent-wallet-mcp
+```
+
+With Claude Code:
+
+```bash
+claude mcp add agent-wallet -- npx -y @keyban/agent-wallet-mcp
+```
+
+The credentials below come from the Keyban admin app, which provisions the
+wallet and hands you a ready-to-paste configuration.
+
+## Configuration
+
+| Variable | Required | What it is |
+|---|---|---|
+| `KEYBAN_API_KEY` | yes | API key of the application the wallet belongs to. Never exposed to the model. |
+| `KEYBAN_APP_ID` | yes | Identifier of the Keyban application. |
+| `KEYBAN_INVITE_KEY` | yes | One-shot ECDSA private key authorizing this client's first-boot registration as a signer. |
+| `KEYBAN_WALLET_ADDRESS` | yes | Address of the account this server drives. |
+| `KEYBAN_NETWORK` | yes | Network the wallet operates on, e.g. `base` or `xdc`. |
+| `KEYBAN_BASE_URL` | no | Backend base URL, or one of `dev`, `testing`, `staging`, `prod`, `sandbox`. Defaults to `https://api.prod.keyban.io`. |
+| `KEYBAN_DKG_BLOB` | no | Pre-generated signer share, base64 JSON. For runtimes with no OS keyring; it does not replace the invite key. |
+| `MCP_LOG_FILE` | no | Path the server writes its log to. |
+| `MCP_LOG_LEVEL` | no | `debug`, `info`, `warn` or `error`. Defaults to `info`. |
+
+## Tools
+
+Read-only:
+
+| Tool | What it does |
+|---|---|
+| `api_status` | Check Keyban API status |
+| `get_account_info` | Get wallet account info |
+| `balance` | Check wallet balance |
+| `list_expense_transactions` | List wallet transactions |
+| `expense_stats` | Get spending statistics |
+| `wait_for_intent` | Wait for approval decisions |
+| `x402_info` | Inspect the x402 price of a URL |
+| `discover_x402_services` | Search the x402 service directory |
+
+Writing:
+
+| Tool | What it does |
+|---|---|
+| `sign_message` | Sign a message |
+| `cancel_intent` | Cancel a pending payment intent |
+| `transfer_usdc` | Transfer USDC — moves funds |
+| `x402_pay` | Pay for an x402 resource — moves funds |
+
+Every tool carries a `title` and the applicable `readOnlyHint` or
+`destructiveHint`, so a client can tell the two groups apart before calling
+anything.
+
+## Spending policy
+
+Transfers and x402 payments are checked against the wallet's policy on the
+Keyban side. A call the policy will not clear on its own does not fail
+silently: it comes back naming a payment intent that needs a human decision.
+`wait_for_intent` blocks until the owner approves or declines, and the agent
+retries once it is approved. The policy lives with the wallet, not with this
+process, so editing this server's configuration cannot widen it.
+
+## Documentation
+
+<https://docs.keyban.io/>
+
+## License
+
+Apache-2.0. See [LICENSE](./LICENSE).

package/package.json

@@ -1,15 +1,29 @@
 {
   "name": "@keyban/agent-wallet-mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MCP server for Keyban agent wallet operations",
   "mcpName": "io.keyban.prod.mcp/agent-wallet",
-  "license": "UNLICENSED",
+  "license": "Apache-2.0",
+  "homepage": "https://docs.keyban.io/",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "wallet",
+    "blockchain",
+    "usdc",
+    "x402",
+    "payments",
+    "keyban"
+  ],
   "type": "module",
   "bin": {
     "agent-wallet-mcp": "./dist/index.mjs"
   },
   "files": [
-    "dist/"
+    "dist/",
+    "LICENSE",
+    "README.md"
   ],
   "dependencies": {
     "@napi-rs/keyring": "^1.2.0",