{"openapi":"3.1.0","info":{"title":"Marathi Sayings API","version":"0.1.0","description":"A fully local, hand-curated reference of 47 verified Marathi mhani (म्हणी, proverbs), each with Devanagari script, romanized transliteration, literal and figurative meaning, a usage example and a theme.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://marathisayings.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/marathisayings/docs"},"termsOfService":"https://connectorbay.com/marathisayings/terms"},"servers":[{"url":"https://marathisayings.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/marathisayings/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 Marathi proverb (mhaṇ), the same for everyone for the whole UTC day, rotating daily. Use for \"give me","description":"One Marathi proverb (mhaṇ), the same for everyone for the whole UTC day, rotating daily. Use for \"give me\n    today's Marathi saying\", \"proverb of the day\".","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/random_saying":{"post":{"operationId":"random_saying","summary":"A randomly chosen Marathi proverb, different (likely) on every call. Use for \"give me a random Marathi","description":"A randomly chosen Marathi proverb, different (likely) on every call. Use for \"give me a random Marathi\n    saying\", \"surprise me with a proverb\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"exclude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A saying id or Devanagari text to exclude, e.g. to avoid repeating the last one shown.","title":"Exclude"}},"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/search_sayings":{"post":{"operationId":"search_sayings","summary":"Keyword search across every saying's Devanagari text, transliteration, literal translation, figurative","description":"Keyword search across every saying's Devanagari text, transliteration, literal translation, figurative\n    meaning and usage example. Use for \"Marathi sayings about greed\", \"find a proverb with the word गाढव\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for, in English or transliterated/Devanagari Marathi.","examples":["greed","hard work","उथळ"],"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 Marathi","description":"Every saying tagged with one theme. Use list_themes to see valid theme names. Use for \"list all Marathi\n    sayings about family\", \"proverbs about foolishness\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"theme":{"description":"A theme name.","examples":["Work & Effort","Greed, Selfishness & Opportunism","Humility & Pride"],"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 explanation of one Marathi proverb: Devanagari script, romanized transliteration, literal","description":"Full explanation of one Marathi proverb: Devanagari script, romanized transliteration, literal\n    word-for-word meaning, the figurative sense it's actually used for, and a natural usage example with English\n    gloss. Use for \"what does उथळ पाण्याला खळखळाट फार mean\", \"explain this Marathi proverb\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's id, Devanagari text, or transliteration.","examples":["उथळ पाण्याला खळखळाट फार","eka hatane tali vajat nahi"],"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/similar_sayings":{"post":{"operationId":"similar_sayings","summary":"Other Marathi sayings related to one given saying, by shared theme or overlapping idea. Use for \"what","description":"Other Marathi sayings related to one given saying, by shared theme or overlapping idea. Use for \"what\n    other Marathi proverbs are like this one\", \"more sayings about the same idea\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"saying":{"description":"A saying's id, Devanagari text, or transliteration to find related sayings for.","minLength":1,"title":"Saying","type":"string"},"limit":{"default":4,"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 covered, with how many sayings are tagged under it. Use for \"what themes of Marathi proverbs","description":"Every theme covered, with how many sayings are tagged under it. Use for \"what themes of Marathi proverbs\n    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 Marathi-language terms relevant to proverbs: mhaṇ vs vākpracār, Devanagari, the letter ळ,","description":"Definitions of Marathi-language terms relevant to proverbs: mhaṇ vs vākpracār, Devanagari, the letter ळ,\n    literal vs figurative meaning. Use for \"what's the difference between a mhaṇ and a vakprachar\".","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}}}}