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 | Person's full name as commonly written; 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)
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.
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.