Order a personalized numerology reading, paid by the person and delivered by email.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The buyer's own email address, also for a gift. The payment confirmation and the private reading link are sent there.
Which reading to buy: "theme", "birthday_portrait" or "name_analysis".
birthday_portrait (optional): the name the reading is addressed to.
theme and name_analysis: every birth surname.
theme and name_analysis: every birth first name, in order.
Date of birth as YYYY-MM-DD. Required for theme and birthday_portrait; not used by name_analysis.
theme and name_analysis (optional): any additional birth names.
Optional short personal note, up to 280 characters, printed at the start of the reading. It never changes the interpretation.
theme only, where it is required: "female" or "male". Sets only the grammatical agreement in the written reading and changes no number.
name_analysis (optional): surnames of the name used today.
name_analysis, with a current name: how much it is used.
theme and name_analysis: one "vowel" or "consonant" per letter Y in the name, in reading order, confirmed by the person. Omitted when the name has no Y.
name_analysis (optional): first names of the name used today, when it differs from the birth name.
name_analysis (optional): middle names of the name used today.
name_analysis, with a current name: where that name is used.
name_analysis (optional): the year the current name came into use.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http readings https://api.numeroclaw.com/mcp/connect
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.
| Argument | Type | Description |
|---|---|---|
| email* | string | The buyer's own email address, also for a gift. The payment confirmation and the private reading link are sent there. |
| product* | string | Which reading to buy: "theme", "birthday_portrait" or "name_analysis". |
| firstName | string | birthday_portrait (optional): the name the reading is addressed to. |
| lastNames | array | theme and name_analysis: every birth surname. |
| firstNames | array | theme and name_analysis: every birth first name, in order. |
| dateOfBirth | string | Date of birth as YYYY-MM-DD. Required for theme and birthday_portrait; not used by name_analysis. |
| middleNames | array | theme and name_analysis (optional): any additional birth names. |
| openingNote | string | Optional short personal note, up to 280 characters, printed at the start of the reading. It never changes the interpretation. |
| subjectGender | string | theme only, where it is required: "female" or "male". Sets only the grammatical agreement in the written reading and changes no number. |
| currentLastNames | array | name_analysis (optional): surnames of the name used today. |
| currentNameScope | string | name_analysis, with a current name: how much it is used. |
| yClassifications | array | theme and name_analysis: one "vowel" or "consonant" per letter Y in the name, in reading order, confirmed by the person. Omitted when the name has no Y. |
| currentFirstNames | array | name_analysis (optional): first names of the name used today, when it differs from the birth name. |
| currentMiddleNames | array | name_analysis (optional): middle names of the name used today. |
| currentNameContexts | array | name_analysis, with a current name: where that name is used. |
| currentNameUsedSinceYear | integer | name_analysis (optional): the year the current name came into use. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"product",
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"maxLength": 254,
"description": "The buyer's own email address, also for a gift. The payment confirmation and the private reading link are sent there."
},
"product": {
"enum": [
"theme",
"birthday_portrait",
"name_analysis"
],
"type": "string",
"description": "Which reading to buy: \"theme\", \"birthday_portrait\" or \"name_analysis\"."
},
"firstName": {
"type": "string",
"maxLength": 80,
"description": "birthday_portrait (optional): the name the reading is addressed to."
},
"lastNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 5,
"description": "theme and name_analysis: every birth surname."
},
"firstNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 5,
"description": "theme and name_analysis: every birth first name, in order."
},
"dateOfBirth": {
"type": "string",
"description": "Date of birth as YYYY-MM-DD. Required for theme and birthday_portrait; not used by name_analysis."
},
"middleNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 5,
"description": "theme and name_analysis (optional): any additional birth names."
},
"openingNote": {
"type": "string",
"maxLength": 280,
"description": "Optional short personal note, up to 280 characters, printed at the start of the reading. It never changes the interpretation."
},
"subjectGender": {
"enum": [
"female",
"male"
],
"type": "string",
"description": "theme only, where it is required: \"female\" or \"male\". Sets only the grammatical agreement in the written reading and changes no number."
},
"currentLastNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 5,
"description": "name_analysis (optional): surnames of the name used today."
},
"currentNameScope": {
"enum": [
"primary",
"frequent",
"context-specific",
"occasional"
],
"type": "string",
"description": "name_analysis, with a current name: how much it is used."
},
"yClassifications": {
"type": "array",
"items": {
"enum": [
"vowel",
"consonant"
],
"type": "string"
},
"maxItems": 40,
"description": "theme and name_analysis: one \"vowel\" or \"consonant\" per letter Y in the name, in reading order, confirmed by the person. Omitted when the name has no Y."
},
"currentFirstNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 5,
"description": "name_analysis (optional): first names of the name used today, when it differs from the birth name."
},
"currentMiddleNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"maxItems": 5,
"description": "name_analysis (optional): middle names of the name used today."
},
"currentNameContexts": {
"type": "array",
"items": {
"enum": [
"professional",
"social",
"legal",
"household",
"other"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "name_analysis, with a current name: where that name is used."
},
"currentNameUsedSinceYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "name_analysis (optional): the year the current name came into use."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| orderId* | string | The order id returned when the order was created. |
| orderToken* | string | The private order token returned when the order was created. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orderId",
"orderToken"
],
"properties": {
"orderId": {
"type": "string",
"description": "The order id returned when the order was created."
},
"orderToken": {
"type": "string",
"description": "The private order token returned when the order was created."
}
},
"additionalProperties": false
}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.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 6, 2026.