Angel Number Today
asterwise_get_angel_number_today
Returns the angel number for today (UTC, or the caller's timezone) or for a given date. All digits of the date are summed and reduced to a single digit (1-9), then the triple sequence of that digit is returned (e.g. digit 9 → angel number 999).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
date | string/null | no | Date to compute the angel number for, YYYY-MM-DD. Overrides timezone. Omit for today. |
timezone | string/null | no | IANA time zone whose current date counts as today, e.g. 'Asia/Kolkata'. Defaults to UTC; ignored when date is given. |
What it covers
Angel numbers are repeated digit sequences interpreted as synchronistic messages in modern spiritual practice. The daily angel number is the same for all callers on the same date — it is a collective daily energy, not personal. Returns the angel number sequence, its theme, primary message, actionable guidance, and associated life areas. Life Path 3 → 333 (creative expression). Today's digit is derived from the date's digit sum.
Workflow
BEFORE: None — standalone.
AFTER: asterwise_get_angel_number_personal — for a personalised angel number from birth date.
Input
date (optional YYYY-MM-DD) or timezone (optional IANA, e.g. Asia/Kolkata); without either, today is the current UTC date. date overrides timezone.
Output contract
data.date (string — YYYY-MM-DD, the date used)
data.timezone (string — zone whose current date was used; omitted when date is given)
data.daily_digit (int — reduced digit 1-9)
data.angel_number (string — e.g. '999')
data.number (string — same as angel_number)
data.theme (string)
data.message (string)
data.guidance (string)
data.areas[] (string array)
Response format
response_format=json serialises the complete response as indented JSON. response_format=markdown renders a human-readable report. Both return identical data.
Compute class
FAST_LOOKUP — pure math, no ephemeris.
Errors
INVALID_PARAMS (local): date not YYYY-MM-DD (schema pattern) → MCP INVALID_PARAMS.
INVALID_PARAMS (upstream): unknown timezone → 422 validation_error, surfaces as MCP INTERNAL_ERROR with the API message.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_angel_number — lookup for a specific number sequence by value.
asterwise_get_angel_number_personal — personalised number from birth date Life Path.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.