{"openapi":"3.1.0","info":{"title":"Kannada Phrases API","version":"0.1.0","description":"A hand-curated everyday Kannada phrasebook covering greetings, courtesy, family, food, directions, shopping, time, emergencies and numbers 1-10, each in real Kannada script with a romanized transliteration and an English meaning.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://kannadaphrases.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/kannadaphrases/docs"},"termsOfService":"https://connectorbay.com/kannadaphrases/terms"},"servers":[{"url":"https://kannadaphrases.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/kannadaphrases/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 Kannada script, transliteration and English meaning. Use for \"how","description":"Keyword search across every phrase's Kannada script, transliteration and English meaning. Use for \"how\n    do you say thank you in Kannada\", \"find Kannada phrases about water\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"An English word, a Kannada word, or a romanized word to search for.","examples":["thank you","water","ನಮಸ್ಕಾರ"],"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 -- greetings, courtesy, family, food, directions, shopping, time,","description":"Every phrase in one category -- greetings, courtesy, family, food, directions, shopping, time,\n    emergencies, numbers (1-10), or basics (question words). Use for \"give me shopping phrases in Kannada\",\n    \"Kannada numbers 1 to 10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"greetings | courtesy | family | food | directions | shopping | time | emergencies | numbers | basics","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":"Suitable Kannada greetings for a given time of day and/or formality level. Use for \"what's a good","description":"Suitable Kannada greetings for a given time of day and/or formality level. Use for \"what's a good\n    morning greeting in Kannada\", \"formal way to greet someone in Kannada\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"time_of_day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"morning | afternoon | evening | night. Omit for any time.","title":"Time Of Day"},"formality":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"formal | informal. Omit for either.","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":"One Kannada phrase picked deterministically for the given (or today's) date -- the same phrase for","description":"One Kannada phrase picked deterministically for the given (or today's) date -- the same phrase for\n    everyone asking about that date. Use for \"Kannada phrase of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An ISO date (YYYY-MM-DD). Omit to use today's date (UTC).","examples":["2026-09-25"],"title":"On 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 family-relationship term in this phrasebook (father, mother, siblings, grandparents, aunt,","description":"Every family-relationship term in this phrasebook (father, mother, siblings, grandparents, aunt,\n    uncle, ...). Use for \"what's the Kannada word for elder sister\".","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":"A phrase's or number's Kannada script paired with its romanized transliteration, the shape needed to","description":"A phrase's or number's Kannada script paired with its romanized transliteration, the shape needed to\n    read it aloud. Use for \"how do you pronounce thank you in Kannada\", \"how do you say 7 in Kannada\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"A phrase (English, Kannada, or romanized) or a number 1-10 to get a pronunciation pairing for.","examples":["thank you","7","ಅಪ್ಪ"],"minLength":1,"title":"Text","type":"string"}},"required":["text"],"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 phrasebook category with how many entries it has. Use for \"what categories of Kannada phrases do","description":"Every phrasebook category with how many entries it has. Use for \"what categories of Kannada phrases do\n    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}}}}