{"openapi":"3.1.0","info":{"title":"Malayalam Phrases API","version":"0.1.0","description":"A hand-curated everyday Malayalam phrasebook: greetings, courtesy, family terms, food, directions, shopping, time and emergencies, each with real Malayalam script verified against a published source, romanized transliteration, and English meaning. Search, browse by category, context-aware greetings, phrase of the day, family terms, and a pronunciation guide.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://malayalamphrases.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/malayalamphrases/docs"},"termsOfService":"https://connectorbay.com/malayalamphrases/terms"},"servers":[{"url":"https://malayalamphrases.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/malayalamphrases/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/phrase_search":{"post":{"operationId":"phrase_search","summary":"Keyword search across every phrase's Malayalam text, transliteration, English meaning, category and","description":"Keyword search across every phrase's Malayalam text, transliteration, English meaning, category and\n    notes. Use for \"how do you say thank you in Malayalam\", \"find phrases about water\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A word or phrase to search for, in English or transliterated Malayalam.","examples":["thank you","water","nandi","toilet"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"phrase_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/phrases_by_category":{"post":{"operationId":"phrases_by_category","summary":"Every phrase in one category. Use categories_list to see valid category names. Use for \"give me shopping","description":"Every phrase in one category. Use categories_list to see valid category names. Use for \"give me shopping\n    phrases in Malayalam\", \"Malayalam emergency phrases\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"greetings | courtesy | family | food | directions | shopping | time | emergencies | numbers","minLength":1,"title":"Category","type":"string"}},"required":["category"],"title":"phrases_by_categoryArguments","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/greeting_for_context":{"post":{"operationId":"greeting_for_context","summary":"Greetings filtered by time of day and/or formality. Use for \"what's a formal Malayalam greeting\", \"good","description":"Greetings filtered by time of day and/or formality. Use for \"what's a formal Malayalam greeting\", \"good\n    morning in Malayalam\", \"an informal way to say hello in Malayalam\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"time_of_day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"morning | evening | night | any. Omit to ignore this filter.","title":"Time Of Day"},"formality":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"formal | informal | neutral | any. Omit to ignore this filter.","title":"Formality"}},"title":"greeting_for_contextArguments","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/phrase_of_the_day":{"post":{"operationId":"phrase_of_the_day","summary":"A deterministic 'phrase of the day' — the same Malayalam phrase for everyone who asks on a given date.","description":"A deterministic 'phrase of the day' — the same Malayalam phrase for everyone who asks on a given date.\n    Use for \"teach me a Malayalam phrase for today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date (YYYY-MM-DD) to pick for; omit for today. Same date always gives the same phrase.","title":"Date"}},"title":"phrase_of_the_dayArguments","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/family_terms":{"post":{"operationId":"family_terms","summary":"Every Malayalam kinship/family term in this reference — mother, father, siblings (with the","description":"Every Malayalam kinship/family term in this reference — mother, father, siblings (with the\n    elder/younger distinction Malayalam always marks), grandparents, aunts/uncles, and more. Use for \"how do you\n    say mother in Malayalam\", \"Malayalam words for family members\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"family_termsArguments","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/pronunciation_guide":{"post":{"operationId":"pronunciation_guide","summary":"Brief, practical notes on Malayalam pronunciation: vowel length, retroflex consonants, the distinctive","description":"Brief, practical notes on Malayalam pronunciation: vowel length, retroflex consonants, the distinctive\n    'zha' sound, schwa deletion, and stress patterns. Use for \"how do you pronounce zha in Malayalam\", \"is\n    Malayalam stress-timed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"vowel length | retroflex consonants | the zha sound | schwa deletion | stress. Omit to see all.","title":"Topic"}},"title":"pronunciation_guideArguments","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/categories_list":{"post":{"operationId":"categories_list","summary":"Every phrase category with how many phrases are filed under each. Use for \"what categories of Malayalam","description":"Every phrase category with how many phrases are filed under each. Use for \"what categories of Malayalam\n    phrases do you have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"categories_listArguments","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}}}}