# LibreTranslate API MCP

> LibreTranslate API allows your agent to handle complex localization and language auditing tasks using free, open-source data. You can ask your AI client to translate text into dozens of languages, detect the primary language of any string, or audit a content catalog for missing translations—all through natural conversation. It gives you instant linguistic insight without ever opening a dedicated translation website.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** machine-translation, language-detection, open-source, api-integration, text-processing

## Description

When working with multilingual content, checking consistency and making sure the right words land in the right cultures is usually a headache. This MCP lets your agent manage that entire process. You don't need to jump through separate portals or maintain dozens of API keys for different services. Instead, you talk to your AI client, and it handles the complexity. It can instantly translate text between multiple languages, check which language a piece of content is written in, and even list every language supported by the service. This means whether you're researching regional market copy or managing complex documentation, your agent acts like an immediate linguistic consultant. By connecting this MCP through Vinkius, you get reliable access to all these translation capabilities, keeping your workflow focused on writing, not API calls.

## Tools

### check_api_status
Checks if the LibreTranslate service is currently running and available for use.

### detect_language
Identifies the language of a specific block of text you provide.

### list_supported_languages
Retrieves a comprehensive list of all languages supported by this instance.

### translate_text
Translates text from one language into another using the open-source translation service.

## Prompt Examples

**Prompt:** 
```
Translate 'Hello world' from English to Portuguese using LibreTranslate.
```

**Response:** 
```
I've translated the text for you! 'Hello world' in Portuguese is identified as 'Olá mundo'. Would you like the full JSON response or a different target language audit?
```

**Prompt:** 
```
Detect the language of the text 'C'est la vie'.
```

**Response:** 
```
I've analyzed the text! It is identified as French (fr) with a confidence score of 99%. I can provide the full metadata list of supported languages if you'd like to confirm.
```

**Prompt:** 
```
List all languages supported by LibreTranslate.
```

**Response:** 
```
I've retrieved the language catalog! There are dozens of languages supported, including English, Spanish, French, and Chinese. I can help you translate text between any of these thematic markers.
```

## Capabilities

### Detect text language
The tool figures out the primary language of any given piece of text.

### Translate content instantly
It translates text from a source language into a specified target language.

### List supported languages
You can get a complete catalog of all languages the service supports.

### Check API operational status
The tool confirms if the translation service is currently working correctly.

## Use Cases

### Auditing a multilingual website's content
A content manager needs to verify if 50 pages have been properly translated into German. They ask their agent to run the `detect_language` tool on all page bodies, then use `translate_text` repeatedly with the target language set to German, immediately flagging any missing or incorrectly coded articles.

### Preparing for international product launch
A technical writer is drafting documentation and needs to confirm if their platform supports Japanese. They use the agent to call `list_supported_languages`, confirming support, and then test a sample string using `translate_text` to ensure proper cultural phrasing.

### Analyzing research data from diverse sources
A researcher collects articles in French, Mandarin, and Portuguese. Instead of manually translating everything, they ask the agent to detect the language for each source using `detect_language`, then translate all non-English snippets into one common format.

### Building a multi-market data pipeline
A developer needs to write a script that processes text from three regions. They use the agent to call `translate_text` for each region and then pass all resulting translations into a single structured output, confirming consistency.

## Benefits

- You get instant language detection. Instead of guessing or manually checking a document's source language, the agent uses `detect_language` to confirm it immediately.
- Stop worrying about API maintenance. You connect once via Vinkius and gain access to translation capabilities without needing to manage multiple vendor credentials.
- Run bulk content audits easily. By calling `translate_text`, you can quickly check semantic distribution across dozens of target languages for consistency checks.
- Gain full linguistic visibility. The `list_supported_languages` tool gives you a complete catalog, helping you plan which markets to localize next.
- Reliable operational status is guaranteed. Using `check_api_status` ensures your agent never fails mid-workflow because the translation service went down.

## How It Works

The bottom line is that your AI client handles all the technical setup; you just tell it what translation work needs doing.

1. First, connect your preferred AI client to this MCP and optionally enter your specific LibreTranslate API Key or custom instance URL.
2. Next, you instruct your agent using natural language commands, asking it to perform a translation, check the language of a document, or list supported codes.
3. Your agent executes the request through the necessary tool calls and returns the translated text, the detected language code, or the complete metadata.

## Frequently Asked Questions

**How does LibreTranslate API MCP handle different dialects?**
The service supports translation between dozens of languages and helps audit semantic distribution. You can use `translate_text` to test how a phrase translates into specific regional variations.

**What is the difference between detecting language and listing supported languages with LibreTranslate API MCP?**
Detecting language (`detect_language`) analyzes *a piece of text* you provide. Listing supported languages tells you *what languages* the entire system can handle.

**Do I need to worry about paying fees when using LibreTranslate API MCP?**
This tool uses open-source data, which means it is designed for reliable, cost-effective usage in professional workflows. Check the specific instance URL provided by your team.

**Can I use LibreTranslate API MCP to translate code snippets?**
The service is built for natural language text and documentation; while you can submit code comments, it's optimized for linguistic content, not functional programming syntax.

**Is the connection stable? How do I check LibreTranslate API MCP status?**
You should always run `check_api_status` at the start of your session. This verifies that the service is operational before you submit any valuable text for translation.

**Is an API Key required for LibreTranslate API?**
No. LibreTranslate is open-source and many public instances allow free requests. However, some instances or the official site may require an API Key for higher limits.

**Can I use a custom self-hosted instance?**
Yes. Provide the `LIBRETRANSLATE_URL` in the server configuration to point your agent to your own private instance.

**Does it support language detection?**
Yes. Use the `detect_language` tool to identify the primary language of any text string along with a confidence metadata score.