About Eclipse Agent Wallet MCP
Eclipse Agent Wallet MCP is a sandbox wallet server for controlling an agent’s simulated USDC spending. Owners set transaction and daily caps, recipient allowlists, and approval thresholds; the server records actions in an append-only audit log and supports an immediate freeze.
Key features
- 01Per-transaction and daily spending caps
- 02Recipient allowlists and approval thresholds
- 03Payment checks and approval queue
- 04Append-only audit log
- 05Immediate wallet freeze
Use cases
- 01Limit an agent’s sandbox spending
- 02Require approval for larger payments
- 03Review payment and policy history
- 04Freeze a wallet to revoke spending authority
MCP support
The server runs over MCP stdio and provides tools for wallet creation, policy management, simulated funding, payment checks and execution, approvals, audit logs, and revocation. Its current implementation uses simulated test USDC in a local JSON ledger and makes no network calls.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
docker run -i --rm -e AGENT_WALLET_LEDGER ghcr.io/cyan-eclipse-technologies-llc/agent-wallet-mcp:2842d69a363c4412a4c1347878fd27b7ca9d9aebAGENT_WALLET_LEDGERPath to the wallet ledger JSON file. Defaults to ledger.json beside the server. Sandbox reference implementation: simulated test USDC only, no real funds.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
ghcr.io/cyan-eclipse-technologies-llc/agent-wallet-mcp:2842d69a363c4412a4c1347878fd27b7ca9d9aebstdioTools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEEclipse Agent Wallet MCP
Powered by Cyan Eclipse Technologies — https://cetech.ai Listed on Eclipse Bazaar (eclipsebazaar.com).
Why this exists
On November 24, 2026, Wells Fargo's Online Access Agreement Section 15 takes effect: anything your AI agent does with your bank account is legally you — "at your own risk," including transactions you did not want or intend, with no controls attached and no duty on the bank to watch.
This MCP server is the opposite design: an agent wallet where responsibility follows scope.
- The human owner grants a written policy: per-transaction cap, daily cap, approval threshold, recipient allowlist, expiry, purpose.
- The agent can spend only inside that scope. Outside it, payments are rejected — or routed to a human approval queue when they exceed only the approval threshold.
- Every grant, payment, rejection, approval and revocation is written to an append-only audit log — the evidence of what was actually authorized.
- A kill switch freezes the wallet instantly, with the revocation timestamped in the log. Revoking access to your bank means "notify us and wait"; here it is immediate and provable.
Status
v0.1.0 reference implementation. Sandbox only — balances are simulated test USDC in a local JSON ledger. No real funds, no private keys, no network calls. The policy engine is the product; production payment rails (x402, partner processors) plug in behind it without changing the tool surface.
Tools (10)
| Tool | What it does |
|---|---|
create_wallet | Create a wallet owned by a named human. Cannot spend until a policy is granted. |
get_wallet | Balance, frozen state, today's spend, active policy. |
set_policy | Owner grants the spending scope; returns a plain-language liability receipt. |
fund_wallet | Sandbox faucet (simulated test USDC) for demos/tests. |
check_payment | Dry-run: returns allow / approve / deny with the reason. Agents call this before pay. |
pay | Execute inside scope; reject outside it; queue for approval above the threshold. |
approve_payment / deny_payment | Owner resolves a queued request. |
audit_log | The full append-only trail. |
revoke | Kill switch — freeze instantly. |
Run it
python3 server.py # MCP over stdio, stdlib only, no dependencies
State persists in ledger.json beside the server (override with AGENT_WALLET_LEDGER).
Use it with your Muse (custom connector / local MCP)
Point your agent's MCP configuration at the command python3 /path/to/server.py — any MCP client (Muse, Muse, Cursor) can drive it. A worked example session:
create_wallet {owner_id: "[email protected]"}→ wallet created, cannot spend.set_policy {per_tx_cap_usdc: "50.00", daily_cap_usdc: "120.00", approval_above_usdc: "20.00", allowlist: ["0xMerchantA"], purpose: "API credits"}→ liability receipt issued.pay 10.00 to 0xMerchantA→ executed.pay 60.00→ rejected (over cap).pay 30.00→ human approval required.revoke→ frozen, timestamped. Agent's authority ends the second the owner says so.
Roadmap
- v0.2: hosted HTTP transport + per-user API keys; policy templates (shopping, SaaS, research budgets).
- v0.3: real rails behind the same policy engine — x402/USDC settlement, partner-processor fiat — only under the owner's granted scope.
- v1.0: Eclipse Bazaar listing with live test-bench scorecard (policy-engine conformance suite runs against every release).
License / attribution
A Cyan Eclipse Technologies product. The "Powered by Cyan Eclipse Technologies" attribution travels with it.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.