{"openapi":"3.1.0","info":{"title":"Lingo API","version":"0.1.0","description":"Translation, language detection, transliteration and romanization, numbers to words, language facts and a travel phrasebook.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://lingo.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/lingo/docs"},"termsOfService":"https://connectorbay.com/lingo/terms"},"servers":[{"url":"https://lingo.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/lingo/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/translate":{"post":{"operationId":"translate","summary":"Translate text between 100+ languages, returning the translation (machine translation, or an exact reviewed memory match","description":"Translate text between 100+ languages, returning the translation (machine translation, or an exact reviewed memory match),\n    translation-memory suggestions, and (for non-Latin scripts) a romanization to read it aloud. Use for \"how do I say X\n    in Hindi\", \"translate this to Japanese\", \"what does this Spanish sentence mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"Text to translate (up to ~500 characters).","examples":["Where is the railway station?"],"title":"Text","type":"string"},"to":{"description":"Target language name or code.","examples":["Hindi","ja","zh-CN","Brazilian Portuguese"],"title":"To","type":"string"},"source":{"default":"auto","description":"Source language name or code, or 'auto'.","title":"Source","type":"string"},"romanize_result":{"default":true,"description":"Add a Latin romanization when the result is in another script.","title":"Romanize Result","type":"boolean"}},"required":["text","to"],"title":"translateArguments","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/detect_language":{"post":{"operationId":"detect_language","summary":"Identify a text's language (with probabilities and alternatives) and the scripts it uses; flags scripts shared","description":"Identify a text's language (with probabilities and alternatives) and the scripts it uses; flags scripts shared\n    by several languages. Use for \"what language is this\", \"is this Hindi or Marathi\", \"which script is this\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"Text to identify.","examples":["मुझे पानी चाहिए","Bonjour tout le monde"],"title":"Text","type":"string"}},"required":["text"],"title":"detect_languageArguments","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/transliterate":{"post":{"operationId":"transliterate","summary":"Convert between Indic scripts and Latin transliteration schemes (e.g. Devanagari → Tamil, ITRANS-typed","description":"Convert between Indic scripts and Latin transliteration schemes (e.g. Devanagari → Tamil, ITRANS-typed\n    'namaste' → Devanagari, Hindi → IAST), Japanese kana/kanji → Hepburn romaji, or anything → a rough Latin\n    romanization. Use for \"write namaste in Tamil script\", \"romanize this Hindi\", \"how is this kanji read\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"Text in any script or in a Latin scheme.","examples":["नमस्ते दुनिया","namaste duniya"],"title":"Text","type":"string"},"to":{"description":"Target: devanagari, bengali, gujarati, gurmukhi, kannada, malayalam, odia, tamil, telugu, iast, itrans, hk (Harvard-Kyoto), latin/roman.","examples":["tamil","iast"],"title":"To","type":"string"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Source scheme if the text is Latin-typed: itrans (default), iast, hk, velthuis.","title":"Source"}},"required":["text","to"],"title":"transliterateArguments","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/romanize":{"post":{"operationId":"romanize","summary":"Latin-letter rendering of any script — Hepburn for Japanese, IAST for Indic scripts, generic Unidecode for","description":"Latin-letter rendering of any script — Hepburn for Japanese, IAST for Indic scripts, generic Unidecode for\n    the rest (Cyrillic, Greek, Hangul, Arabic, Chinese pinyin without tones). Use for \"how do I pronounce this\",\n    \"write this in English letters\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"Text in a non-Latin script.","examples":["ありがとうございます","Привет мир","안녕하세요","मुझे पानी चाहिए"],"title":"Text","type":"string"}},"required":["text"],"title":"romanizeArguments","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_to_words":{"post":{"operationId":"number_to_words","summary":"Spell a number in words in the chosen language — cardinal, ordinal or year form, or as an amount of money —","description":"Spell a number in words in the chosen language — cardinal, ordinal or year form, or as an amount of money —\n    plus Indian English (lakh/crore) and Indian digit grouping for English, and native Devanagari words for Hindi.\n    Use for \"1,234,567 in words\", \"write 42nd in French\", \"₹12,50,000 in words for a cheque\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"number":{"description":"The number.","examples":[1234567,42,1999.5],"title":"Number","type":"number"},"language":{"default":"English","description":"Language name or code (40+ supported; Hindi native).","examples":["English","Hindi","fr","es","ja"],"title":"Language","type":"string"},"form":{"default":"cardinal","description":"cardinal | ordinal | year","title":"Form","type":"string"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO currency code to spell as money, e.g. USD, EUR, INR (cardinal only).","title":"Currency"}},"required":["number"],"title":"number_to_wordsArguments","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/language_info":{"post":{"operationId":"language_info","summary":"Facts about a language: native name, ISO codes, script, family, total and native speakers, main countries,","description":"Facts about a language: native name, ISO codes, script, family, total and native speakers, main countries,\n    writing direction — or the languages of a script or a country. Use for \"how many people speak Telugu\", \"which\n    languages use the Cyrillic script\", \"languages spoken in Nigeria\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Language name or code.","examples":["Telugu","sw","Portuguese"],"title":"Language"},"script":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Instead: list languages using a script, e.g. Devanagari, Cyrillic, Arabic.","title":"Script"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Instead: list languages of a country, e.g. India, Nigeria.","title":"Country"}},"title":"language_infoArguments","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/phrasebook":{"post":{"operationId":"phrasebook","summary":"Essential travel phrases (greetings, thanks, help, directions, ordering, money) in the target language with","description":"Essential travel phrases (greetings, thanks, help, directions, ordering, money) in the target language with\n    a pronunciation guide — all 25 or just one. Use for \"basic Japanese phrases\", \"how to say thank you in Tamil\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"description":"Hindi, Spanish, French, German, Portuguese, Italian, Arabic, Japanese, Mandarin, Korean, Russian or Tamil.","examples":["Japanese","hi"],"title":"Language","type":"string"},"phrase":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One phrase to look up, e.g. 'thank you', 'where is the toilet'.","title":"Phrase"}},"required":["language"],"title":"phrasebookArguments","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}}}}