Introduction

WelcomeServices map

Guides

AcceptSpend

Legal

SecurityPrivacyTerms
PreviousCapabilitiesNextDirectory
BlogPrivacyTerms

Resolve a pay destination

Turn an @handle, handle FQDN, or agent FQDN into a pay address and agent list before you transfer.

Same flow over HTTP: GET /handles/resolve/:destination

Tool

rill_resolve_handle

Call this before a background ledger transfer with rill_pay to=… so you confirm the destination exists. Open-world Spend with rill_pay_url usually targets an HTTPS gate URL instead of a handle, so resolve is optional on that path.

Auth

No key required. Available on guest and full MCP sessions.

Parameters

ParameterTypeRequiredDescription
handlestringyes@handle, handle.userill.com, or agent.handle.userill.com

Usage notes

  • Leading @ is optional and stripped for you.
  • Use the resolved address with rill_pay for in-Rill A2A transfers.
  • Same flow over HTTP: GET /handles/resolve/:destination.