{"openapi":"3.1.0","info":{"title":"Bengali Sayings API","version":"0.1.0","description":"A fully local, hand-curated reference of 56 traditional Bengali (Bangla) proverbs and sayings, each given in real Bengali script with a romanized transliteration, literal and figurative meaning, and a usage note, organized by theme. Keyless; zero upstream API calls; nothing stored.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://bengalisayings.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/bengalisayings/docs"},"termsOfService":"https://connectorbay.com/bengalisayings/terms"},"servers":[{"url":"https://bengalisayings.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/bengalisayings/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":"One Bengali proverb, deterministically chosen for today's date (UTC) -- the same for every caller on the","description":"One Bengali proverb, deterministically chosen for today's date (UTC) -- the same for every caller on the\n    same day. Use for \"give me today's Bengali saying\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"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 Bengali text, romanization, literal/figurative meaning, usage note","description":"Keyword search across every saying's Bengali text, romanization, literal/figurative meaning, usage note\n    and theme. Use for \"Bengali proverbs about friendship\", \"sayings mentioning money\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for.","examples":["greed","friend","money"],"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 tagged with one theme. Use list_themes to see valid theme names. Use for \"list all Bengali","description":"Every saying tagged with one theme. Use list_themes to see valid theme names. Use for \"list all Bengali\n    proverbs about wisdom and folly\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"description":"A theme name.","examples":["Greed & Contentment","Friendship & Loyalty"],"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":"Full detail for one saying: Bengali script, romanization, literal (word-for-word) meaning, figurative","description":"Full detail for one saying: Bengali script, romanization, literal (word-for-word) meaning, figurative\n    (actual) meaning, and a usage note describing when it's said. Use for \"explain this Bengali proverb\",\n    \"what does অতি লোভে তাঁতি নষ্ট mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's Bengali text, romanization, or id.","examples":["অতি লোভে তাঁতি নষ্ট","Oti lobhe tanti noshto"],"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":"One Bengali proverb chosen at random. Use for \"surprise me with a Bengali saying\".","description":"One Bengali proverb chosen at random. Use for \"surprise me with a Bengali saying\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"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 or a similar lesson with the given one. Use for \"what other Bengali","description":"Other sayings that share a theme or a similar lesson with the given one. Use for \"what other Bengali\n    proverbs mean something similar to অতি লোভে তাঁতি নষ্ট\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's Bengali text, romanization, or id 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 in each. Use for \"what themes of Bengali","description":"Every theme used to group sayings, with how many sayings are in each. Use for \"what themes of Bengali\n    proverbs do you cover\".","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 proverb-related terms: probad (proverb), probochon, literal vs. figurative meaning, theme,","description":"Definitions of proverb-related terms: probad (proverb), probochon, literal vs. figurative meaning, theme,\n    usage note. Use for \"what does 'probad' mean\", \"what's the difference between literal and figurative meaning\".","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}}}}