{"openapi":"3.1.0","info":{"title":"Malayalam Sayings API","version":"0.1.0","description":"A hand-curated Malayalam proverb (pazhamchollu) reference: 40+ real proverbs with genuine Malayalam script, romanized transliteration, literal and figurative meaning, and a usage note. Search, browse by theme, saying of the day, similar-saying suggestions, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://malayalamsayings.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/malayalamsayings/docs"},"termsOfService":"https://connectorbay.com/malayalamsayings/terms"},"servers":[{"url":"https://malayalamsayings.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/malayalamsayings/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/saying_of_the_day":{"post":{"operationId":"saying_of_the_day","summary":"A deterministic 'saying of the day' — the same Malayalam proverb, with its full detail, for everyone who","description":"A deterministic 'saying of the day' — the same Malayalam proverb, with its full detail, for everyone who\n    asks on a given date. Use for \"give me today's Malayalam saying\".","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 saying.","title":"Date"}},"title":"saying_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/search_sayings":{"post":{"operationId":"search_sayings","summary":"Keyword search across every saying's Malayalam text, transliteration, literal meaning, figurative meaning,","description":"Keyword search across every saying's Malayalam text, transliteration, literal meaning, figurative meaning,\n    usage note and theme. Use for \"find a Malayalam proverb about greed\", \"search for sayings mentioning an\n    elephant\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for, in English or transliterated Malayalam.","examples":["patience","family","elephant","muttathe mullakku"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"search_sayingsArguments","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/sayings_by_theme":{"post":{"operationId":"sayings_by_theme","summary":"Every saying filed under one theme. Use list_themes to see valid theme names. Use for \"list Malayalam","description":"Every saying filed under one theme. Use list_themes to see valid theme names. Use for \"list Malayalam\n    proverbs about wisdom\", \"show me sayings about family\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"description":"A theme name — see list_themes.","examples":["Patience & Effort","Family & Upbringing","Human Nature"],"minLength":1,"title":"Theme","type":"string"}},"required":["theme"],"title":"sayings_by_themeArguments","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/explain_saying":{"post":{"operationId":"explain_saying","summary":"One saying's full detail: Malayalam script, transliteration, literal meaning, figurative meaning, and a","description":"One saying's full detail: Malayalam script, transliteration, literal meaning, figurative meaning, and a\n    usage note describing when a native speaker would actually use it. Use for \"explain this Malayalam proverb\",\n    \"what does this saying really mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's id, its Malayalam text, or its transliteration.","examples":["muttathe mullakku manamilla","adi thettiyaal aanayum veezhum"],"minLength":1,"title":"Saying","type":"string"}},"required":["saying"],"title":"explain_sayingArguments","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/random_saying":{"post":{"operationId":"random_saying","summary":"A random Malayalam saying, optionally limited to one theme. Use for \"give me a random Malayalam","description":"A random Malayalam saying, optionally limited to one theme. Use for \"give me a random Malayalam\n    proverb\", \"surprise me with a saying about caution\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Limit the random pick to one theme; omit for any saying.","title":"Theme"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Optional seed for a reproducible pick.","title":"Seed"}},"title":"random_sayingArguments","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/similar_sayings":{"post":{"operationId":"similar_sayings","summary":"Other sayings that share a theme (and some wording) with a given one — useful for \"what else is like","description":"Other sayings that share a theme (and some wording) with a given one — useful for \"what else is like\n    this proverb\". Use for \"show me sayings similar to 'minnunnathellaam ponnalla'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's id, Malayalam text, or transliteration to find similar sayings for.","minLength":1,"title":"Saying","type":"string"},"limit":{"default":4,"description":"Maximum number of similar sayings to return.","maximum":10,"minimum":1,"title":"Limit","type":"integer"}},"required":["saying"],"title":"similar_sayingsArguments","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/list_themes":{"post":{"operationId":"list_themes","summary":"Every theme used to group sayings, with how many sayings are filed under each. Use for \"what themes of","description":"Every theme used to group sayings, with how many sayings are filed under each. Use for \"what themes of\n    Malayalam proverbs do you have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_themesArguments","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/glossary":{"post":{"operationId":"glossary","summary":"Definitions of a few Malayalam-proverb-related terms: pazhamchollu, aksharam, figurative meaning, usage","description":"Definitions of a few Malayalam-proverb-related terms: pazhamchollu, aksharam, figurative meaning, usage\n    note, theme. Use for \"what does pazhamchollu mean\".","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":"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}}}}