NumeroClaw MCP Server

Creates an unpaid order for one NumeroClaw reading and returns a link to a NumeroClaw page where the person checks the order and pays. It is for when the person has seen and confirmed the product, the price, the email address and the details below. Creating the order charges nothing, and an unpaid order expires after 24 hours. Payment is taken at purchase and the reading is written afterwards. It is emailed to the address given: usually within a few hours and always within 6 hours. Readings are written for adults, so this is not for a reading about a child. One order covers one reading for one person, so a second order for the same person and reading is a second purchase. If a paid reading has not arrived in that time, the person can write to [email protected] with the order id. Inputs by product. theme: firstNames and lastNames exactly as on the birth record (middleNames optional), dateOfBirth and subjectGender. birthday_portrait: dateOfBirth, and optionally firstName to address the reading to. name_analysis: the birth name (firstNames, lastNames, middleNames optional) and no dateOfBirth; if the person uses a different name today, it goes in currentFirstNames, currentLastNames and currentMiddleNames, with currentNameContexts and currentNameScope. Every product needs email. Dates are YYYY-MM-DD. Names with the letter Y need yClassifications, one value per Y anywhere in the name, including at the end of a name, in reading order: first names, then middle names, then last names, and for name_analysis the birth name before the current name. A Y is a vowel sound when it sounds like the Y in Amy or Kelly, and a consonant sound when it starts a syllable and sounds like the Y in yes, as in Yolanda. The sound decides, not the position: Yvonne is said ee-von, so its Y is a vowel sound, and "Yolanda Kelly" gives ["consonant", "vowel"]. Each Y is worked out from how the name sounds and confirmed by the person in plain words, because most people cannot say whether a Y is a vowel or a consonant without an example. The classification changes the numbers in the reading. Returns orderId and orderToken (a private value that is the only key to the order), product, amount, currency, paymentLink, expiresAt and charged: false. During a sale, amount is the sale price and priceNote says until when. Invalid details return a list of issues and create no order.

Returns the status of a NumeroClaw reading order. Use it when the person asks whether their order is paid or their reading is ready. Inputs: orderId and orderToken, both returned when the order is created. Returns the status (awaiting_payment, expired, paid, queued, processing, completed or failed), the amount, the payment link while the order is unpaid, how long it usually takes while it is being written, and a short message for the person. The reading itself is sent only by email, to the address given with the order. A reading that is still being written has not failed: it is usually ready within a few hours and always within 6 hours. A failed status means the reading could not be produced and the payment will be refunded after a person at NumeroClaw reviews it.

Lists the numerology readings available from NumeroClaw: Theme, Name Analysis and Birthday Portrait. Use it when someone asks which readings are available, what they cost, or what details a reading needs. Takes no input. Returns, for each reading, its product id (theme, name_analysis or birthday_portrait), name, description, price in US dollars and any running sale, delivery time, refund terms, links to read about it and to a complete sample where one exists, whether it can be ordered now, and the details it requires.