Mobile Number Check
asterwise_check_mobile_number
Sums the digits of the national number (country code left out), reduces them to a single number, and returns harmonic scoring plus interpretive copy.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mobile_number | string | yes | Mobile number to analyse; digits only, country code optional. |
name | string/null | no | Not used: the analysis depends only on the digits. Omit it; it is accepted only so older calls keep working. |
date | string/null | no | Not used: the analysis depends only on the digits. Omit it; it is accepted only so older calls keep working. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
country | string/null | no | Country of the number as ISO 3166 alpha-2, e.g. 'IN', 'US', 'CN'. Used only when the number has no '+'/'00' prefix: it is then read as dialled in that country and the country code is left out of the sum. |
What it covers
Accepts formats like bare ten digits, plus-country-code with spaces or hyphens; non-digits are ignored. Valid numbers written with '+' or '00' are parsed and the country code and trunk prefix are dropped. Without a prefix, pass country so the number is read as dialled in that country; with no country, only India's 12-digit 91… form is shortened and every other number is summed exactly as written. The result depends only on the digits; owner name and birth date are optional and not used. Not for vehicle plates (asterwise_check_vehicle_number) or business names.
Workflow
BEFORE: RECOMMENDED — asterwise_get_numerology_profile — anchor Life Path before judging the line.
AFTER: None.
Input
Only digits count; the country calling code is never counted. Numbers written with '+' or '00' use the national number. Without a prefix, pass country (ISO 3166 alpha-2, e.g. IN, US, CN) so the number is read as dialled in that country; with no country, only India's 12-digit 91… form is shortened and every other number is summed exactly as written (e.g. 14155552671 without country sums all 11 digits = 42; with country=US it is 41). With country, the number is read as dialled there first, international dialling prefix included (e.g. AU 0011, US 011). A '+'/'00' number drops its country code only when it is a valid number: an invalid '+' number sums every digit after '+', an invalid '00' number is summed as written.
Output contract
data.input (string — submitted number)
data.input_type (string — 'mobile')
data.total (int — sum of data.digits_used)
data.single_digit (int — Pythagorean root, one through nine)
data.is_master (bool — true when the total or a step of its reduction is 11, 22 or 33)
data.master_number (int — that master number; omitted when none)
data.digits_used (string — the digits summed: the national number without the country code)
data.country_code (int — calling code left out of the sum; omitted when none was left out)
data.theme (string)
data.favourable_for[] (string array)
data.caution (string)
data.harmony_score (int — one through ten)
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 — no fields are added, removed, or filtered by either mode.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (local — caught before upstream call):
— country not two letters → MCP INVALID_PARAMS
INVALID_PARAMS (upstream):
— 422 validation_error when the number has no digits or only zeros (details[].issue no_digits | digits_sum_to_zero), or country is unknown (issue unknown_country); surfaces as MCP INTERNAL_ERROR with the API message.
INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
— Punctuation is ignored; a leading '+' or '00' marks an international number whose country code is dropped.
Do not confuse with
asterwise_check_vehicle_number — plate digit rules, not SIM numbering.
asterwise_get_business_name_analysis — letter Expression scan, not phone roots.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.