Sign Up Anonymously
horizon_signup_anonymousCreates an anonymous guest player account from a display name and returns an anonymousToken for first-launch guest play without email. Use only for new guests, not email signups or returning guests.
Instructions
Creates a new anonymous (guest) player account that needs only a display name and returns its anonymousToken. Use when: a player starts without email, for example on first launch of a game with guest play. Not for: players who sign up with email and password (use horizon_signup_email) or returning guests (use horizon_signin_anonymous with the stored anonymousToken). Side effects: creates one new player account per call after the player chooses guest play. Omitted/false includeRefreshToken starts no session; true also issues access and refresh tokens. Never automatically repeat an uncertain signup. Returns: {userId, username, isAnonymous: true, anonymousToken, authStatus, createdAt}, plus session tokens only when opted in. The server alone issues the 32-character anonymousToken. Store it in platform secure storage. Without accessToken, call horizon_signin_anonymous. Errors: 400 for an invalid displayName: fix the name and retry. Needs HORIZON_API_KEY. Every failure returns an error result (isError) with the HTTP status and body: a 401 that horizon_test_connection also returns means HORIZON_API_KEY is wrong, 429 means the account's per-minute rate limit was reached (wait a minute, then retry).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"displayName": "<displayName>"
},
"name": "horizon_signup_anonymous"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| displayName | Yes | Display name shown on leaderboards (max 30 characters) | |
| includeRefreshToken | No | Explicit opt-in to a rotating 30-day refresh session; omitted or false preserves access-only behavior. Store refresh tokens in platform secure storage |