Wallet as a Service

v1.0.0Finance & Fintechstable

📇 🏠 🍎 🪟 🐧 - Self-hosted wallet-as-a-service for AI agents. 60 tools for multi-chain c

ai-agentblockchaincryptodefiethereum
Share:
26
Stars
0
Downloads
0
Weekly
0/5

What is Wallet as a Service?

Wallet as a Service is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 🍎 🪟 🐧 - self-hosted wallet-as-a-service for ai agents. 60 tools for multi-chain c

📇 🏠 🍎 🪟 🐧 - Self-hosted wallet-as-a-service for AI agents. 60 tools for multi-chain c

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Manage multi-chain cryptocurrency wallets for AI agents.
Execute blockchain transactions and DeFi operations.
Enable secure self-hosted wallet functionality without external services.
LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 14, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx waiaas

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Wallet as a Service

WAIaaS (Wallet as a Service) is a self-hosted MCP server that gives AI agents a full-featured, multi-chain cryptocurrency wallet with 60+ tools for token transfers, balance checking, contract interactions, batch transactions, and DeFi integrations including Jupiter, 0x, LI.FI, Lido, and Jito. It supports Solana, Ethereum, Polygon, Arbitrum, Optimism, and Base, and implements a four-tier policy engine (INSTANT, NOTIFY, DELAY, APPROVAL) so developers can precisely control how autonomously an agent can transact. Teams building DeFi automation, payment agents, or any AI-driven blockchain workflow can deploy WAIaaS locally and connect to it via MCP without relying on custodial services.

Prerequisites

  • Node.js 18+ installed for running the CLI
  • npm to install the @waiaas/cli package globally
  • A master password (created on first run) to protect your self-hosted wallet daemon
  • Funded wallets or test-network credentials for the chains you plan to use
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Install the WAIaaS CLI globally

Install the CLI tool that manages the wallet daemon, session tokens, and MCP server startup.

npm install -g @waiaas/cli
2

Initialize WAIaaS configuration

Run init to create the data directory and generate the default config.toml file where you configure RPC endpoints and notification channels.

waiaas init
3

Start the daemon and set your master password

Start the wallet daemon for the first time. You will be prompted to create a master password which encrypts all key material on disk.

waiaas start
4

Provision wallets and create an MCP session

Use quickset to auto-provision wallets for the desired network and generate an MCP session token for Claude to authenticate with.

waiaas quickset --mode mainnet
# Or for testnet:
waiaas quickset --mode testnet
5

Configure your MCP client

Add WAIaaS to your Claude Desktop config file, pointing to the local daemon and providing the session token generated by quickset.

{
  "mcpServers": {
    "waiaas": {
      "url": "http://127.0.0.1:3100/mcp",
      "headers": {
        "Authorization": "Bearer your_waiaas_session_token"
      }
    }
  }
}
6

Access the admin UI

Open the browser-based admin dashboard to manage wallets, view balances, set transaction policies, and review logs.

# Open in your browser:
http://127.0.0.1:3100/admin

Wallet as a Service Examples

Client configuration

Connect Claude Desktop to your locally running WAIaaS daemon using the HTTP MCP transport and session token.

{
  "mcpServers": {
    "waiaas": {
      "url": "http://127.0.0.1:3100/mcp",
      "headers": {
        "Authorization": "Bearer your_waiaas_session_token_here"
      }
    }
  }
}

Prompts to try

Sample prompts exercising wallet operations, balance queries, and DeFi interactions across supported chains.

- "Check my ETH balance on mainnet and Arbitrum"
- "Send 0.01 ETH to 0xRecipientAddress on Polygon"
- "Swap 100 USDC to ETH using the best available route via LI.FI"
- "What are my current token holdings across all connected wallets?"
- "Stake 1 SOL via Jito and show me the expected yield"
- "Execute a batch transfer: send 10 USDC to each of these 5 addresses on Base"

Troubleshooting Wallet as a Service

MCP client cannot connect to the WAIaaS server at 127.0.0.1:3100

Ensure the WAIaaS daemon is running with `waiaas start`. Check that no firewall or process is blocking port 3100. Run `waiaas status` to confirm the daemon is active, and verify the WAIAAS_SESSION_TOKEN in your client config is current.

Transaction fails with 'policy denied' or requires approval

WAIaaS implements a four-tier policy engine. Large or high-risk transactions may be set to DELAY or APPROVAL tier by default. Log into the admin UI at http://127.0.0.1:3100/admin to review and approve pending transactions or adjust policy thresholds.

Docker alternative fails with permission errors on volume mounts

When using Docker Compose, ensure the data directory created by `waiaas init` is owned by your user and the compose file volume path matches the actual init directory. Run `chmod 700 ~/.waiaas` to set correct permissions.

Frequently Asked Questions about Wallet as a Service

What is Wallet as a Service?

Wallet as a Service is a Model Context Protocol (MCP) server that 📇 🏠 🍎 🪟 🐧 - self-hosted wallet-as-a-service for ai agents. 60 tools for multi-chain c It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Wallet as a Service?

Follow the installation instructions on the Wallet as a Service GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Wallet as a Service?

Wallet as a Service works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Wallet as a Service free to use?

Yes, Wallet as a Service is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "waiaas": { "command": "npx", "args": ["-y", "waiaas"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Wallet as a Service?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides