Read a user's SOMA Coins wallet (read-only, token required)
get_walletREAD-ONLY wallet summary for a SOMA app user: their SOMA Coins balance plus a summary of coins expiring within the next 30 days. Requires a wallet token that only the human can generate inside the SOMA mobile app (Wallet tab → 'Share balance with your AI') — ask them for it; tokens expire after ~10 minutes. This tool can never claim, redeem, spend, or move coins (there are deliberately no claim/redeem tools over MCP). Returns { error: 'invalid_or_expired_token' } for a bad or stale token — ask the user to generate a fresh one in the app.
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": {
"wallet_token": "<wallet_token>"
},
"name": "get_wallet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wallet_token | Yes | The short-lived wallet token the user generated in the SOMA app (Wallet tab → 'Share balance with your AI') and pasted to you |