{"openapi":"3.1.0","info":{"title":"Telugu Sayings API","version":"0.1.0","description":"A fully local, hand-curated reference of real Telugu-script proverbs and sayings (సామెతలు): 40 verified entries, each with Telugu text, romanized transliteration, literal meaning, figurative meaning and a usage note, plus keyword search, theme browsing, 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://telugusayings.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/telugusayings/docs"},"termsOfService":"https://connectorbay.com/telugusayings/terms"},"servers":[{"url":"https://telugusayings.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/telugusayings/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 Telugu proverb picked deterministically for a given date (today by default), with its Telugu text,","description":"One Telugu proverb picked deterministically for a given date (today by default), with its Telugu text,\n    transliteration, literal meaning, figurative meaning and usage note. Use for \"give me a Telugu saying of\n    the day\", \"proverb for today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"for_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date (YYYY-MM-DD); omit for today. Deterministic — the same date always returns the same saying.","title":"For 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 Telugu text, transliteration, literal/figurative meaning, usage","description":"Keyword search across every saying's Telugu text, transliteration, literal/figurative meaning, usage\n    note and theme. Use for \"Telugu proverbs about greed\", \"find a saying mentioning grapes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword, theme, or English phrase to search for.","examples":["patience","greed","delay","grapes"],"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 \"Telugu sayings","description":"Every saying filed under one theme. Use list_themes to see valid theme names. Use for \"Telugu sayings\n    about luck\", \"list every proverb about honesty\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"description":"A theme name.","examples":["Prudence & Caution","Greed & Desire","Luck & Fortune"],"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 breakdown: the Telugu text, transliteration, a literal (word-for-word) meaning, a","description":"One saying's full breakdown: the Telugu text, transliteration, a literal (word-for-word) meaning, a\n    figurative (real-world) meaning, and a usage note showing the situation it's said in. Use for \"what does\n    this Telugu proverb mean\", \"explain ఆలస్యం అమృతం విషం\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's Telugu text, transliteration, or a keyword from it.","examples":["ఆలస్యం అమృతం విషం","sour grapes","mirror doesn't lie"],"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 single random Telugu saying with its full detail. Use for \"surprise me with a Telugu proverb\".","description":"A single random Telugu saying with its full detail. Use for \"surprise me with a Telugu proverb\".","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 the same life-theme and overlapping vocabulary with a given one. Use for","description":"Other sayings that share the same life-theme and overlapping vocabulary with a given one. Use for\n    \"what other Telugu proverbs are like this one\", \"more sayings about patience like this\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's Telugu text, transliteration, or a keyword from it.","minLength":1,"title":"Saying","type":"string"},"limit":{"default":4,"description":"Maximum results.","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 this reference covers, with how many sayings are filed under each. Use for \"what","description":"Every theme this reference covers, with how many sayings are filed under each. Use for \"what\n    categories of Telugu 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 recurring proverb-related terms: సామెత (proverb), భావం (figurative meaning), జాతీయం","description":"Definitions of recurring proverb-related terms: సామెత (proverb), భావం (figurative meaning), జాతీయం\n    (idiom), నుడికారం (colloquial turn of phrase), and a few culturally-specific words that appear inside\n    individual sayings (అక్షింతలు, గారెలు, కావడి). Use for \"what does సామెత mean\", \"what's the difference\n    between సామెత and జాతీయం\".","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}}}}