WAIaaS

WAIaaS runs as a self-hosted wallet daemon with an MCP server that lets AI agents interact with on-chain wallets and policies through the Model Context Protocol. After you start the daemon, you can either integrate with Claude Desktop/Code via the MCP path or use Skill Files for REST-style integration. The MCP path exposes wallet tools (send tokens, check balances, manage policies) through an MCP-compatible interface, enabling agents to perform transactions with owner-approved safeguards. You can also manage everything through the Admin UI, including sessions, policies, and notifications. To get started, initialize and start the daemon, then generate MCP config snippets for your agent, or use the quickstart flow to provision wallets and MCP sessions automatically. The alternative path provides pre-built Skill files that you can drop into your agent's context to learn the WAIaaS API via simple REST-like calls. Finally, an Admin UI at /admin helps you monitor wallets, sessions, policies, and system settings.

Prerequisites:

• Node.js 22 LTS and npm
• Optional: Docker if you prefer containerized deployment
• Basic familiarity with CLI tools

Install and run (CLI-based)

1. Install the CLI globally npm install -g @waiaas/cli

2. Initialize your environment (data directory + config) waiaas init

3. Start the daemon waiaas start

4. Create wallets and MCP sessions in one step (optional) waiaas quickset --mode mainnet

5. Access the MCP config snippet for your agent (Claude path) or proceed to configure via the Admin UI

Alternative: Docker

1. Clone and run the stack with Docker Compose git clone https://github.com/minho-yoo/waiaas.git && cd waiaas docker compose up -d

2. The daemon will be exposed at http://127.0.0.1:3100 by default.

Prerequisites summary: ensure you have Node.js 22+, npm, and network access for package installs or Docker if using the containerized route.

Tips and notes:

• The Admin UI at http://127.0.0.1:3100/admin requires a master password (set during first run or via auto-provision).
• The MCP path (Path A) is ideal for Claude-based agents supporting MCP. Paste the generated MCP configuration into Claude's config or use waiaas mcp setup --all to auto-register wallets/sessions.
• Path B allows any AI agent to learn the WAIaaS API through Skill files; the available skills include setup, quickstart, wallet, transactions, policies, admin, actions, x402.
• For automated/self-contained provisioning, use the auto-provision flow to generate a recovery key and seed the master password locally.
• If using Docker, the daemon exposes the HTTP API (default port 3100). Ensure firewall rules permit access from your agent host.
• The system supports multiple networks (Solana and EVM) and a 12-tier policy engine with various guards and notifications; configure spending limits and owner approvals as needed.