Introduction

WelcomeServices map

Guides

AcceptSpend

Legal

SecurityPrivacyTerms
PreviousAccountsNextVerify receipt
BlogPrivacyTerms

Create a wallet

Create a wallet with a budget (rill_vw_*), period allowance, per-pay max, and optional allowlist.

Same flow over HTTP: Wallets API

Tool

rill_create_wallet

Create a wallet after claim and fund on the owner path. The MCP session adopts the new key for later Spend tools. Set period_allowance and max_transaction in USD (decimal dollars). Optional allowlist and policy_template_id apply fleet defaults for many agents sharing one template.

Auth

Owner Supabase JWT required. The account wallet should already be funded or pays will fail with insufficient balance.

Parameters

ParameterTypeRequiredDescription
account_wallet_idstringyesFunded account wallet that backs this wallet
agent_slugstringnoSlug for the agent FQDN; defaults to agent
period_allowancenumbernoUSD budget for the policy period
max_transactionnumbernoUSD cap for a single pay
allowliststring[]noAllowed resource or destination patterns
policy_template_idstringnoFleet template that supplies default caps
owner_jwtstringnoOverrides session JWT for this call

Usage notes

  • Save rill_vw_* immediately, it is shown once on create.
  • Check remaining budget later with rill_balance and vw_key.
  • Primary pay tool after mint is rill_pay_url against any MPP/x402 HTTPS URL.
  • Same flow over HTTP: POST /wallets.