# How to integrate LILT MCP with Hermes

```json
{
  "title": "How to integrate LILT MCP with Hermes",
  "toolkit": "LILT MCP",
  "toolkit_slug": "lilt_mcp",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/lilt_mcp/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/lilt_mcp/framework/hermes-agent.md",
  "updated_at": "2026-09-04T05:35:59.461Z"
}
```

## Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.
This guide explains the easiest and most robust way to connect your LILT account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

## Also integrate LILT MCP with

- [ChatGPT Work](https://composio.dev/toolkits/lilt_mcp/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/lilt_mcp/framework/claude-cowork)

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:
- Search and load tools from relevant toolkits on-demand, reducing context usage.
- Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
- Manage app authentication end-to-end with zero manual overhead.

## Connect LILT MCP to Hermes

### Integrating LILT with Hermes
### Using Composio Connect CLI
1. Install the Composio CLI
Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

```bash
curl -fsSL https://composio.dev/install | bash
```

## What is the LILT MCP server, and what's possible with it?

The LILT MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your LILT account. It provides structured and secure access so your agent can perform LILT operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `LILT_MCP_CHECK_JOB_STATUS` | Check job status | Checks the status of a verified translation job. |
| `LILT_MCP_CREATE_TRAINED_MODEL` | Create trained model | Creates a new trained translation model for a specific language pair. Use this tool when a user wants to improve translation quality for a specific language pair by creating a translation model that can be trained with their own data. This is a prerequisite for using `translate_files_with_verification` for that language pair. |
| `LILT_MCP_DOWNLOAD_JOB` | Download job | Triggers a job export and returns a download link for the completed job. |
| `LILT_MCP_GET_CREDIT_BALANCE_INFORMATION` | Get credit balance information | Retrieves all available credit balances for the authenticated user. Instant credits refresh every month. You get a certain amount to use every month. Every month the credits refresh. Verified credits don't expire. Once they are purchased you will always have them. Use this tool to check the current balance for both instant and verified translation credits. Returns: dict[str, int]: A dictionary representing the credits with the following keys: - instant_translation(int): The number of instant translation credits - verified_translation(int): The number of verified translation credits |
| `LILT_MCP_HELLO_WORLD` | Hello world | Returns a friendly hello world message. |
| `LILT_MCP_LIST_RESOURCES` | List resources | Lists and filters jobs or models. |
| `LILT_MCP_TRANSLATE_FILES_WITH_VERIFICATION` | Translate files with verification | Create a verified translation job that will be assigned to professional LILT linguists for translation and review. IMPORTANT TWO-STEP WORKFLOW: STEP 1 - Get Quote (user_confirmed=False, default): - Call this tool WITHOUT user_confirmed or with user_confirmed=False - Returns a quote showing credits needed, current balance, and detailed breakdown - NO job is created, NO credits are deducted - Show the user the quote and ask for explicit confirmation STEP 2 - Create Job (user_confirmed=True): - Only after user explicitly confirms, call this tool again with user_confirmed=True - Creates the job and deducts credits - Returns the created job details Credit Handling: - If insufficient_credits=True: Inform user they don't have enough credits and suggest purchasing more at https://mcp.lilt.com/home - If credits are sufficient but low (10 or fewer): Warn user about low balance and suggest purchasing more credits - If credits are sufficient: Show quote details (credits needed, current balance, balance after) and ASK FOR EXPLICIT CONFIRMATION before proceeding to step 2 If the tool throws a ValueError related to no trained models existing for a language pair, then tell this to the user and ask if they would like to create a trained model. |
| `LILT_MCP_TRANSLATE_TEXT` | Translate text | Translates text using LILT's instant translate API. Use this tool when you need to translate text from one language to another using LILT's neural translation models. IMPORTANT: Check the 'insufficient_credits' field in the response. If True, inform the user they don't have enough credits and suggest purchasing more instant translation credits at https://mcp.lilt.com/home. If the user has sufficient credits but their balance is running low (5,000 credits or fewer), inform them about the remaining balance and suggest purchasing more credits to avoid interruptions. In the response object, if the "used_trained_model" is false, then tell the user that the translation was done with a LILT base model. If the user wants to improve the translation quality or match their brand voice they should create a trained model. Ask the user if they would like to create a trained model. |
| `LILT_MCP_UPLOAD_FILE` | Upload file | Upload a file to LILT for translation. This tool handles file uploads. For non-plain-text file formats like PDF, DOCX, RTF, etc., it assumes the client has extracted the text content. To indicate that only the text is being used, the tool appends a `.txt` extension to the original filename (e.g., `report.docx` becomes `report.docx.txt`). IMPORTANT: You must inform the user of this behavior. When a user uploads a file like a PDF or DOCX, confirm by saying: "I am uploading the extracted text from your file [original_filename] for translation." |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The LILT MCP server provides comprehensive access to LILT operations through Composio. Once connected, Hermes can perform all major LILT actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With LILT connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.
From here, you can extend Hermes further:
- Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
- Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
- Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.
If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build LILT MCP Agent with another framework

- [ChatGPT Work](https://composio.dev/toolkits/lilt_mcp/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/lilt_mcp/framework/claude-cowork)

## Related Toolkits

- [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.
- [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze.
- [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization.
- [ActiveMerge](https://composio.dev/toolkits/active_merge) - ActiveMerge is a document automation platform for generating documents, images, merged files, and e-signature workflows. It helps teams turn templates and stored files into finished, shareable documents faster.
- [Affinda](https://composio.dev/toolkits/affinda) - Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data.
- [Agility cms](https://composio.dev/toolkits/agility_cms) - Agility CMS is a headless content management system for building and managing digital experiences across platforms. It lets teams update content quickly and deliver omnichannel experiences with ease.
- [Airparser](https://composio.dev/toolkits/airparser) - Airparser is an AI-powered parser for extracting structured data from emails, documents, PDFs, and files. It turns messy inbound content into clean fields your apps and workflows can use.
- [Algodocs](https://composio.dev/toolkits/algodocs) - Algodocs is an AI-powered platform that automates data extraction from business documents. It delivers fast, secure, and accurate processing without templates or manual training.
- [Api2pdf](https://composio.dev/toolkits/api2pdf) - Api2Pdf is a REST API for generating PDFs from HTML, URLs, and documents using powerful engines like wkhtmltopdf and Headless Chrome. It streamlines document conversion and automation for developers and businesses.
- [Aryn](https://composio.dev/toolkits/aryn) - Aryn is an AI-powered platform for parsing, extracting, and analyzing data from unstructured documents. Use it to automate document processing and unlock actionable insights from your files.
- [Boldsign](https://composio.dev/toolkits/boldsign) - Boldsign is a digital eSignature platform for sending, signing, and tracking documents online. Organizations use it to automate agreements and manage legally binding workflows efficiently.
- [Boloforms](https://composio.dev/toolkits/boloforms) - BoloForms is an eSignature platform built for small businesses, offering unlimited signatures, templates, and forms. It simplifies digital document signing and team collaboration at a predictable, fixed price.
- [Box](https://composio.dev/toolkits/box) - Box is a cloud content management and file sharing platform for businesses. It helps teams securely store, organize, and collaborate on files from anywhere.
- [Box MCP](https://composio.dev/toolkits/box_mcp) - Box MCP is Box's hosted MCP server that exposes enterprise files, folders, and metadata. It provides secure, centralized access to corporate content for search and management.
- [Carbone](https://composio.dev/toolkits/carbone) - Carbone is a blazing-fast report generator that turns JSON data into PDFs, Word docs, spreadsheets, and more using flexible templates. It lets you automate document creation at scale with minimal code.
- [Castingwords](https://composio.dev/toolkits/castingwords) - CastingWords is a transcription service specializing in human-powered, accurate transcripts via a simple API. Get seamless audio-to-text conversion for interviews, meetings, podcasts, and more.
- [CertSeal](https://composio.dev/toolkits/cert_seal) - CertSeal is an API platform for issuing and managing verifiable digital certificates. Use it to automate trusted certificate workflows for recipients, batches, designs, and webhooks.
- [Cloudconvert](https://composio.dev/toolkits/cloudconvert) - CloudConvert is a powerful file conversion service supporting over 200 file formats. It streamlines converting, compressing, and managing documents, media, and more, all in one place.
- [Cloudlayer](https://composio.dev/toolkits/cloudlayer) - Cloudlayer is a document and asset generation service for creating PDFs and images via API or SDKs. It lets you automate high-quality doc creation, saving dev time and reducing manual work.
- [CloudPDF](https://composio.dev/toolkits/cloud_pdf) - CloudPDF is an API platform for creating, uploading, managing, and sharing PDF documents. Use it to build secure PDF workflows with webhooks, share links, and access control.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and LILT MCP?

With a standalone LILT MCP server, the agents and LLMs can only access a fixed set of LILT tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from LILT and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right LILT tools.

### Can I manage the permissions and scopes for LILT while using Tool Router?

Yes, absolutely. You can configure which LILT scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your LILT data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)