How to Use the LibreTranslate API MCP in LlamaIndex

Q: Can LlamaIndex index the outputs of the LibreTranslate API?

Yes, outputs from translatetext or detectlanguage can be parsed directly into Document objects. You can then index these documents into your vector store for future semantic searches.

Q: How do I check which languages the LibreTranslate API supports in LlamaIndex?

Your LlamaIndex agent can call listsupportedlanguages to retrieve the active list of language codes. This list can be cached or used dynamically to validate user queries before translation.

Q: How does the LibreTranslate API MCP Server protect my LlamaIndex text data?

The raw text strings processed by translatetext are held only in ephemeral memory during execution. Vinkius does not write your documents or search queries to disk, ensuring your proprietary data remains private.

Index translated content and detect source languages in your LlamaIndex RAG pipelines using the LibreTranslate API MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect LibreTranslate API MCP to LlamaIndex

Create your Vinkius account to connect LibreTranslate API to LlamaIndex and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup LibreTranslate API with LlamaIndex

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Translate documents before indexing them into LlamaIndex

The `translate_text` tool localizes raw document chunks before they hit your LlamaIndex vector stores. Your ingestion pipeline can automatically translate foreign language documents into a target language, ensuring your index remains unified and searchable. You get consistent embeddings because all source material is translated before vectorization. This setup prevents semantic search failures caused by language mismatches. Your query engine can retrieve relevant nodes even if the original documents were written in different languages.

Detect query languages to routing your LlamaIndex searches

The `detect_language` tool allows your LlamaIndex query routers to identify the language of incoming user queries. Once the language is identified, your router can dynamically select the appropriate language-specific index or run a translation step. This keeps your search pipeline fast and accurate. If the detected language is not supported, your pipeline can call `list_supported_languages` to find a matching alternative. This ensures your search engine never fails silently when confronted with unfamiliar inputs.

Keep your LlamaIndex RAG pipelines online with health checks

The `check_api_status` tool lets your LlamaIndex data agents verify the availability of the translation service before processing queries. By running this check during the initial query phase, your agent avoids attempting translations on an offline server. This saves compute cycles and prevents user-facing timeouts. Integrating this health check ensures your RAG pipeline remains reliable. If the tool reports an issue, your agent can route queries to a non-translated index or return a clean error message.

Setup guide

Set up LibreTranslate API MCP in LlamaIndex

Prerequisites

Python 3.10+ installed
llama-index-tools-mcp package
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install llama-index-tools-mcp llama-index-llms-openai. The MCP tools package provides BasicMCPClient and McpToolSpec.
2

Connect with BasicMCPClient
Point BasicMCPClient to your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports SSE and Streamable HTTP transports.
3

Convert to LlamaIndex tools
Call mcp_tool_spec.to_tool_list_async() to convert all LibreTranslate API MCP tools into native FunctionTool objects that any LlamaIndex agent can use.
4

Run with any LLM
Create a FunctionAgent with the tools and your preferred LLM. Swap OpenAI for Anthropic, Gemini, or any LlamaIndex-supported provider.

agent.py

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI

# Connect to the MCP
mcp_client = BasicMCPClient(
    "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)
mcp_tool_spec = McpToolSpec(client=mcp_client)

# Convert MCP tools to LlamaIndex tools
tools = await mcp_tool_spec.to_tool_list_async()

# Create and run the agent
agent = FunctionAgent(
    tools=tools,
    llm=OpenAI(model="gpt-4o"),
    system_prompt="You have access to LibreTranslate API tools.",
)
response = await agent.run("List recent LibreTranslate API data")

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by LibreTranslate. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect LibreTranslate API now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about LibreTranslate API MCP in LlamaIndex

You install llama-index-tools-mcp and initialize the BasicMCPClient with your Vinkius server URL. Then, convert the client to a tool list and pass it to your LlamaIndex FunctionAgent.

Yes, outputs from `translate_text` or `detect_language` can be parsed directly into Document objects. You can then index these documents into your vector store for future semantic searches.

Your LlamaIndex agent can call `list_supported_languages` to retrieve the active list of language codes. This list can be cached or used dynamically to validate user queries before translation.

Yes, you configure the connection details in Vinkius to point to your self-hosted LibreTranslate instance. LlamaIndex communicates with the secure Vinkius endpoint, keeping your local backend shielded.

The raw text strings processed by `translate_text` are held only in ephemeral memory during execution. Vinkius does not write your documents or search queries to disk, ensuring your proprietary data remains private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript