intentions_set_birth_info
Call once to register the user's birth date/time/gender. Each call is a complete replacement — all 6 fields must be supplied. For fields the user does not know or prefers not to share, pass null explicitly (e.g. hour: null for unknown birth time, gender: null for unspecified). To update just one field, first call intentions_get_profile to fetch the current values, merge the user's new input, then call this tool with the full merged payload. Changes to the date, gender or a known hour (including setting a known hour back to null) are limited to 3 per calendar month (UTC); filling in a previously-null hour, or the minute, is always free. intentions_get_profile returns how many are left. Always pass birthPlace (the city of birth, e.g. "Portland, Maine") when the user gives it: readings then use the real moment of birth there, daylight saving included. Omit it only to keep the stored one; changing it is free. If the call fails with birth_time_needs_confirming, the clocks changed over that time at the birthplace: ask the user which it was and call again with birthTimeFold (0 = the earlier, 1 = the later). Returns the element profile.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": "<year>",
"month": "<month>",
"day": "<day>",
"hour": "<hour>",
"minute": "<minute>",
"gender": "<gender>"
},
"name": "intentions_set_birth_info"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| day | Yes | Birth day of month, 1–31. | |
| hour | Yes | null if unknown | |
| year | Yes | Birth year, 1920–2030. | |
| month | Yes | Birth month, 1–12. | |
| gender | Yes | null if unspecified | |
| minute | Yes | null if unknown; requires hour to also be non-null | |
| birthPlace | No | City of birth, optionally with region or country ("Portland, Maine"). Ask the user for it. Omit or null only to keep the stored birthplace. | |
| birthTimeFold | No | Only after a birth_time_needs_confirming error: 0 = the earlier of the two possible moments, 1 = the later. |