{"openapi":"3.1.0","info":{"title":"Marathi Phrases API","version":"0.1.0","description":"A fully local, hand-curated Marathi everyday phrasebook: 62 verified phrases across 8 categories plus numbers 1-10, each with Devanagari script, romanized transliteration and English meaning.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://marathiphrases.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/marathiphrases/docs"},"termsOfService":"https://connectorbay.com/marathiphrases/terms"},"servers":[{"url":"https://marathiphrases.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/marathiphrases/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/phrase_search":{"post":{"operationId":"phrase_search","summary":"Keyword search across every phrase's English meaning, Devanagari text and transliteration. Use for \"how","description":"Keyword search across every phrase's English meaning, Devanagari text and transliteration. Use for \"how\n    do you say thank you in Marathi\", \"find a phrase 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":["thank you","hospital","किती"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"phrase_searchArguments","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/phrases_by_category":{"post":{"operationId":"phrases_by_category","summary":"Every phrase in one of 8 categories: greetings, courtesy, family, food, directions, shopping, time,","description":"Every phrase in one of 8 categories: greetings, courtesy, family, food, directions, shopping, time,\n    emergencies. Use categories_list to see valid category names. Use for \"Marathi phrases for shopping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"A category name.","examples":["Greetings","Shopping","Emergencies"],"title":"Category","type":"string"}},"required":["category"],"title":"phrases_by_categoryArguments","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/greeting_for_context":{"post":{"operationId":"greeting_for_context","summary":"Suggests the right Marathi greeting for a given time of day and formality level. Use for \"what's a good","description":"Suggests the right Marathi greeting for a given time of day and formality level. Use for \"what's a good\n    Marathi greeting in the evening\", \"how do I formally greet someone in Marathi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"time_of_day":{"default":"any","description":"'morning', 'afternoon', 'evening', 'night', or 'any'.","examples":["morning","evening","any"],"title":"Time Of Day","type":"string"},"formality":{"default":"any","description":"'formal', 'informal', or 'any'.","examples":["formal","informal"],"title":"Formality","type":"string"}},"title":"greeting_for_contextArguments","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/phrase_of_the_day":{"post":{"operationId":"phrase_of_the_day","summary":"One Marathi phrase, the same for everyone for the whole UTC day, rotating daily. Use for \"Marathi phrase","description":"One Marathi phrase, the same for everyone for the whole UTC day, rotating daily. Use for \"Marathi phrase\n    of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"phrase_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/family_terms":{"post":{"operationId":"family_terms","summary":"Every Marathi family/kinship word: mother, father, brother, sister, husband, wife, son, daughter,","description":"Every Marathi family/kinship word: mother, father, brother, sister, husband, wife, son, daughter,\n    grandparents. Use for \"how do you say mother in Marathi\", \"Marathi words for family members\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"family_termsArguments","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/pronunciation_guide":{"post":{"operationId":"pronunciation_guide","summary":"A brief, purely descriptive guide to Marathi pronunciation: vowels, aspirated consonants, and the","description":"A brief, purely descriptive guide to Marathi pronunciation: vowels, aspirated consonants, and the\n    retroflex ळ letter that distinguishes Marathi from everyday Hindi. Use for \"how is ळ pronounced\", \"what's an\n    aspirated consonant in Marathi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pronunciation_guideArguments","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/number_word":{"post":{"operationId":"number_word","summary":"A number word 1-10 in Marathi, with Devanagari script and transliteration. For deeper numeral coverage","description":"A number word 1-10 in Marathi, with Devanagari script and transliteration. For deeper numeral coverage\n    across Indian languages, see a dedicated numbers connector. Use for \"how do you say five in Marathi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"A number from 1 to 10.","maximum":10,"minimum":1,"title":"Number","type":"integer"}},"required":["number"],"title":"number_wordArguments","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/categories_list":{"post":{"operationId":"categories_list","summary":"Every phrase category covered, with how many phrases are in it. Use for \"what categories of Marathi","description":"Every phrase category covered, with how many phrases are in it. Use for \"what categories of Marathi\n    phrases do you have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"categories_listArguments","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}}}}