Soul Urge Number
asterwise_get_soul_urge_number
Calculates the Soul Urge (Heart's Desire) number from vowels in the full name. Only A, E, I, O, U are treated as vowels — Y is always a consonant in this system. Reduces each name part separately before summing, preserving master numbers 11, 22, 33.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Full legal name as used at birth, all parts; its letters are converted to numerology values. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
What it covers
The Soul Urge reveals the inner motivation — what the soul craves, what drives choices at the deepest level. It is the hidden engine beneath the Expression. This is the most private of the three core name numbers.
Workflow
BEFORE: None — standalone.
AFTER: asterwise_get_personality_number — complete the name number trinity.
Input
name — Full legal name as used at birth.
Example: 'Arjun Mehta', 'Sofia Rossi'
Y is always treated as a consonant — not a vowel.
Output contract
data.number (int — Soul Urge number; 11/22/33 preserved as master)
data.is_master_number (bool)
data.karmic_debt_number (int or null — 13, 14, 16 or 19 met anywhere in the reduction of the total; null otherwise)
Response format
response_format=json serialises the complete response as indented JSON — use this for programmatic parsing, typed clients, and downstream tool chaining.
response_format=markdown renders the same data as a human-readable report.
Both modes return identical underlying data.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (local): None — validation is upstream.
INVALID_PARAMS (upstream): 422 validation_error with details[].issue = no_letters when the name has no letters A-Z (e.g. '123', '!!!', or a name written only in a non-Latin script) — ask the user for the name spelled in Latin letters; this is not a server fault.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_expression_number — all letters, not vowels only.
asterwise_get_personality_number — consonants only, not vowels.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.