{"openapi":"3.1.0","info":{"title":"Ank API","version":"0.1.0","description":"A fully local Vedic/Chaldean numerology calculator: life-path and name numbers, combined profiles, number meanings, compatibility notes, lucky dates, name-spelling variants and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://ank.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/ank/docs"},"termsOfService":"https://connectorbay.com/ank/terms"},"servers":[{"url":"https://ank.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/ank/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/life_path_number":{"post":{"operationId":"life_path_number","summary":"The life-path/destiny number for a birth date: every digit of the full date is summed and reduced to","description":"The life-path/destiny number for a birth date: every digit of the full date is summed and reduced to\n    1-9 (or left as a master number 11/22/33), with a trait description. Use for \"what's my life path number\n    for 1990-04-23\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date_of_birth":{"description":"Birth date, e.g. 1990-04-23 (YYYY-MM-DD; DD-MM-YYYY and MM/DD/YYYY are also accepted).","examples":["1990-04-23","23-04-1990"],"title":"Date Of Birth","type":"string"}},"required":["date_of_birth"],"title":"life_path_numberArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/name_number":{"post":{"operationId":"name_number","summary":"A name's number (expression/destiny number): each letter's value under the Chaldean or Pythagorean","description":"A name's number (expression/destiny number): each letter's value under the Chaldean or Pythagorean\n    system is summed and reduced to 1-9 (or a master number). Use for \"what's the name number for Priya Sharma\n    in Chaldean numerology\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A full name (letters only are used; spaces and punctuation are ignored).","examples":["Priya Sharma"],"minLength":1,"title":"Name","type":"string"},"system":{"default":"chaldean","description":"chaldean | pythagorean — which letter-value table to use.","title":"System","type":"string"}},"required":["name"],"title":"name_numberArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/numerology_profile":{"post":{"operationId":"numerology_profile","summary":"A combined numerology snapshot: life-path number, name number (Chaldean), and a lucky number, day,","description":"A combined numerology snapshot: life-path number, name number (Chaldean), and a lucky number, day,\n    color and gemstone drawn from the life path's ruling planet. Use for \"give me my numerology profile\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Full name.","minLength":1,"title":"Name","type":"string"},"date_of_birth":{"description":"Birth date, e.g. 1990-04-23.","title":"Date Of Birth","type":"string"}},"required":["name","date_of_birth"],"title":"numerology_profileArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/number_meaning":{"post":{"operationId":"number_meaning","summary":"Full traits, ruling planet, and lucky day/color/gemstone for a single numerology number (1-9, or a","description":"Full traits, ruling planet, and lucky day/color/gemstone for a single numerology number (1-9, or a\n    master number). Use for \"what does the number 7 mean in numerology\", \"what is a master number 22\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"A number: 1-9, or a master number 11, 22 or 33.","title":"Number","type":"integer"}},"required":["number"],"title":"number_meaningArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compatibility":{"post":{"operationId":"compatibility","summary":"A short traditional-numerology-folklore compatibility note between two life-path or name numbers. Use","description":"A short traditional-numerology-folklore compatibility note between two life-path or name numbers. Use\n    for \"are life path 3 and 6 compatible\", \"how do 8 and 1 get along in numerology\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number_a":{"description":"First number: 1-9, or 11/22/33.","title":"Number A","type":"integer"},"number_b":{"description":"Second number: 1-9, or 11/22/33.","title":"Number B","type":"integer"}},"required":["number_a","number_b"],"title":"compatibilityArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/lucky_dates":{"post":{"operationId":"lucky_dates","summary":"Every calendar date in a given month whose digits reduce to a chosen favorable number, per traditional","description":"Every calendar date in a given month whose digits reduce to a chosen favorable number, per traditional\n    numerology practice. Use for \"which dates in October 2026 are lucky for a life path 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"The target number: 1-9, or 11/22/33.","title":"Number","type":"integer"},"month":{"description":"Calendar month, 1-12.","maximum":12,"minimum":1,"title":"Month","type":"integer"},"year":{"description":"Calendar year, e.g. 2026.","maximum":9999,"minimum":1,"title":"Year","type":"integer"}},"required":["number","month","year"],"title":"lucky_datesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/name_number_search":{"post":{"operationId":"name_number_search","summary":"Playful minor spelling variants of a name (adding a silent letter, doubling a letter, common letter","description":"Playful minor spelling variants of a name (adding a silent letter, doubling a letter, common letter\n    swaps) ranked by how close their name-number lands to a target number. A fun cultural exercise, not a\n    guarantee. Use for \"how could I spell Kiran to get a name number of 6\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"target_number":{"description":"The name-number to aim for: 1-9, or 11/22/33.","title":"Target Number","type":"integer"},"seed_name":{"description":"A starting name to suggest variants of.","minLength":1,"title":"Seed Name","type":"string"},"system":{"default":"chaldean","description":"chaldean | pythagorean.","title":"System","type":"string"},"limit":{"default":8,"description":"Max number of suggestions to return.","maximum":20,"minimum":1,"title":"Limit","type":"integer"}},"required":["target_number","seed_name"],"title":"name_number_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/numerology_glossary":{"post":{"operationId":"numerology_glossary","summary":"Definitions of core numerology terms (life path number, master number, Chaldean vs Pythagorean systems,","description":"Definitions of core numerology terms (life path number, master number, Chaldean vs Pythagorean systems,\n    karmic debt number, soul urge number, ...). Use for \"what's a master number\", \"what's the Chaldean\n    system\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"numerology_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}