Introduction

WelcomeServices map

Guides

AcceptSpend

Legal

SecurityPrivacyTerms
PreviousDiscoverNextOrg slug
BlogPrivacyTerms

Register a bootstrap agent

Self-register with a short proof-of-work challenge and get a starter wallet key for Spend.

Tool

rill_register_agent

Cold-start step one on /mcp/guest. After success, the session adopts the wallet key so fund and pay tools work without pasting credentials. Next: rill_fund action=checkout → send the Stripe URL to a human → poll action=intent → rill_pay_url. (rill_fund can also auto-register if you skip this tool.)

Auth

No prior key. Guest-safe. The tool solves PoW against the API and returns a rill_vw_* or rill_vw_test_* key.

Parameters

ParameterTypeRequiredDescription
labelstringnoOptional human label for the bootstrap agent
environmentlive | testnoMoney mode (default live). test mints rill_vw_test_* into a Test wallet.

Usage notes

  • Save api_key immediately, it is shown once.
  • Bootstrap allowances are tighter than owner-created wallets; read rill_capabilities for current caps.
  • If pay fails with insufficient balance, call rill_fund action=checkout and have a human pay, then retry.
  • Same flow over HTTP: POST /agent/register/challenge then POST /agent/register with optional environment.