Claude Code Integration Guide

2026-02-10

Claude Code Integration Guide

This guide walks you through connecting WAIaaS to Claude Code, Anthropic's official CLI for Claude. WAIaaS provides two integration methods: skill files and MCP server.

Quick Setup

1. Initial Setup

If WAIaaS is not yet installed, follow the setup skill (waiaas-setup/SKILL.md) for CLI installation, daemon startup, wallet creation, and session configuration.

2. Install WAIaaS Skills

npx @waiaas/skills claude-code

This installs 8 WAIaaS skill files to .claude/skills/ in your project directory:

.claude/skills/
  waiaas-setup/SKILL.md
  waiaas-quickstart/SKILL.md
  waiaas-wallet/SKILL.md
  waiaas-transactions/SKILL.md
  waiaas-policies/SKILL.md
  waiaas-admin/SKILL.md
  waiaas-actions/SKILL.md
  waiaas-x402/SKILL.md

3. Configure Session Token

Add your WAIaaS session credentials to .claude/settings.json in your project directory:

{
  "env": {
    "WAIAAS_BASE_URL": "http://localhost:3100",
    "WAIAAS_SESSION_TOKEN": "<your-session-token>"
  }
}

Note: If using MCP integration instead, waiaas mcp setup manages tokens automatically — no manual environment variable setup is required.

4. Use in Claude Code

Claude Code automatically discovers skills in .claude/skills/. You can:

MCP Integration (Alternative)

For direct tool access (18 MCP tools), connect WAIaaS as an MCP server:

waiaas mcp setup

This writes the MCP configuration to your Claude Desktop config. Claude Code can then use WAIaaS tools directly (e.g., get_balance, send_transaction).

The MCP server includes a connect_info tool that returns all accessible wallets, policies, and capabilities. Call it first to understand your environment. No WAIAAS_WALLET_ID environment variable is needed -- the agent discovers wallets via connect-info.

Skills vs MCP

Feature Skills MCP
Setup npx @waiaas/skills claude-code waiaas mcp setup
How it works Claude reads skill docs and uses curl Claude calls MCP tools directly
Tools available All REST API endpoints via curl 18 dedicated MCP tools
Auth Manual header setup per request Automatic (token file)
Best for Learning the API, custom workflows Production use, automated agents

You can use both simultaneously. Skills provide comprehensive API documentation while MCP provides streamlined tool access.

Available Skills

Skill Description
waiaas-setup Zero-state daemon setup: install CLI, initialize, start daemon, create wallet, configure session
waiaas-quickstart End-to-end quickset: create wallet, session, check balance, send first transfer
waiaas-wallet Wallet CRUD, asset queries, session management, token registry, MCP provisioning
waiaas-transactions All 5 transaction types (TRANSFER, TOKEN_TRANSFER, CONTRACT_CALL, APPROVE, BATCH)
waiaas-policies Policy engine: 12 policy types for spending limits, whitelists, rate limits
waiaas-admin Admin API: daemon status, kill switch, notifications, settings management
waiaas-actions Action Provider framework: DeFi actions through the transaction pipeline
waiaas-x402 x402 auto-payment protocol: fetch URLs with automatic cryptocurrency payments

Updating Skills

To update to the latest skill files:

npx @waiaas/skills claude-code --force

See Also

Troubleshooting

Skills not detected by Claude Code

Verify the skill files are in the correct location:

ls .claude/skills/waiaas-*/SKILL.md

Make sure you are running Claude Code from the project root where .claude/skills/ was created.

Connection refused

Make sure the WAIaaS daemon is running:

curl http://localhost:3100/health

MCP connection issues

If using MCP integration, verify the setup:

waiaas mcp setup --check

Related