{"openapi":"3.1.0","info":{"title":"Hindi Sayings API","version":"0.1.0","description":"A fully local, hand-curated reference of 55 real Hindi proverbs and sayings (लोकोक्तियाँ) in Devanagari script, each with a romanized transliteration, literal meaning, figurative meaning, an original usage example, and a life theme. Search by keyword or theme, get a saying of the day or a random one, find similar sayings, and look up terms in a Hindi-linguistics glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://hindisayings.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/hindisayings/docs"},"termsOfService":"https://connectorbay.com/hindisayings/terms"},"servers":[{"url":"https://hindisayings.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/hindisayings/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 Hindi saying, deterministically chosen for a given date (or today if omitted), so everyone","description":"One Hindi saying, deterministically chosen for a given date (or today if omitted), so everyone\n    calling on the same day gets the same saying. Use for \"saying of the day\", \"today's Hindi proverb\".","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.","examples":["2026-09-25"],"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 Devanagari text, transliteration, literal meaning,","description":"Keyword search across every saying's Devanagari text, transliteration, literal meaning,\n    figurative meaning, theme and usage example. Use for \"Hindi proverb about greed\", \"sayings similar\n    to 'a bird in hand'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword or phrase to search for, in Hindi or English.","examples":["greed","once bitten","मुँह में राम"],"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 life theme. Use list_themes to see valid theme names. Use for","description":"Every saying filed under one life theme. Use list_themes to see valid theme names. Use for\n    \"list Hindi proverbs about hope\", \"sayings about hypocrisy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"description":"A theme name.","examples":["Perseverance & Hope","Hypocrisy & Appearances","Greed & Contentment"],"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: Devanagari text, transliteration, literal (word-for-word) meaning,","description":"Full detail for one saying: Devanagari text, transliteration, literal (word-for-word) meaning,\n    figurative (real-life) meaning, an original usage example sentence, and its theme. Use for \"what\n    does this Hindi proverb mean\", \"explain जहाँ चाह वहाँ राह\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's Devanagari text, transliteration, or id.","examples":["मुँह में राम, बगल में छुरी","jahaan chaah vahaan raah","andhon mein kaana raja"],"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 randomly chosen Hindi saying, full detail included. Use for \"give me a random Hindi proverb\".","description":"A randomly chosen Hindi saying, full detail included. Use for \"give me a random Hindi proverb\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"seed":{"anyOf":[{"type":"string"},{"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 teach a related lesson — same theme, ranked by overlap in figurative meaning.","description":"Other sayings that teach a related lesson — same theme, ranked by overlap in figurative meaning.\n    Use for \"what other Hindi proverbs mean something like this one\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's Devanagari text, transliteration, or id to find others like it.","minLength":1,"title":"Saying","type":"string"},"limit":{"default":4,"description":"Max 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 life theme covered, with how many sayings are filed under each (e.g. Perseverance & Hope,","description":"Every life theme covered, with how many sayings are filed under each (e.g. Perseverance & Hope,\n    Hypocrisy & Appearances, Cause & Effect). Use for \"what themes of Hindi 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 Hindi linguistics/culture terms used throughout this reference — lokokti,","description":"Definitions of Hindi linguistics/culture terms used throughout this reference — lokokti,\n    kahawat, muhaavara, arth, bhaavaarth, Devanagari, maatra, anusvaar. Use for \"what's the difference\n    between a lokokti and a muhaavara\", \"what's a maatra\".","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}}}}