Waafir
Connect AI Tools

waafir-translate reference

The waafir-translate server exposes Waafir's text translation to a connected AI client. It is the short-text, synchronous counterpart of the in-product AI Translation feature: where the product feature translates whole documents and preserves their layout, this tool translates a snippet of text and returns the result inline.

This server is positioned as experimental — the surface may change.

Connection: https://app.waafir.io/api/mcp/waafir-translate — see Setup. Requires a read-scope (or higher) PAT.

translate_text

Translate a short text into a target language. The call is synchronous and text-in / text-out. Omit the source language to have it detected automatically; the detected (or supplied) source is returned so you can confirm it.

Inputs

FieldTypeRequiredDescription
textstringyesThe text to translate, 1–10,000 UTF-8 bytes.
target_langstringyesTarget language code, e.g. fr, ar, es.
source_langstringnoSource language code. Omit to auto-detect.

Output

{ translated_text, detected_source_lang }
  • translated_text — the text rendered in the target language.
  • detected_source_lang — the source language that was used: the one you supplied, or the one auto-detected when source_lang was omitted.

Size limit

Because the tool is the synchronous path, text is limited to 10,000 UTF-8 bytes per call. Input over that limit returns a clear error rather than being silently truncated. For larger content — whole documents — use the document translation feature, which is built for files and preserves their layout.