Herramientas MCP estándar
Conoce las 18 herramientas MCP de AI Glot, organizadas por tarea, los permisos que requieren, sus efectos secundarios y el recurso de idiomas disponibles.
El servidor estándar ofrece herramientas organizadas por tareas, en lugar de reproducir uno por uno todos los endpoints REST.
Herramientas de cuenta y uso
| Tool | Scope | Qué hace |
|---|---|---|
get_account | account:read | Consulta el espacio de trabajo, el plan, los créditos, los límites y las funciones disponibles |
get_credit_balance | account:read | Consulta el saldo y cada una de las asignaciones de crédito |
get_usage | usage:read | Consulta los créditos, las palabras y las traducciones completadas a lo largo del tiempo |
Herramienta para enviar comentarios
| Tool | Scope | Qué hace |
|---|---|---|
send_feedback | None beyond authentication | Registra comentarios en texto libre sobre un resultado inesperado, un comportamiento confuso o algo que te gustaría que funcionara de otra manera |
Usa send_feedback cuando el problema esté claro. Explica la situación, lo que ocurrió y lo que debería haber ocurrido. Si lo sabes, indica también la acción relacionada, el modelo de IA y el entorno del agente. No incluyas claves de API, tokens, URL firmadas ni el contenido íntegro de archivos. No consume créditos ni modifica ninguna traducción.
Las herramientas de cuenta y uso son de solo lectura y no consumen créditos.
Herramientas de traducción
| Tool | Scope | Qué hace |
|---|---|---|
list_batches | batches:read | Muestra las traducciones existentes mediante paginación por cursor |
get_batch | batches:read | Consulta una traducción, su progreso y el plan de revisión actual |
show_translation | batches:read | Muestra la revisión interactiva en los hosts compatibles con MCP Apps |
get_batch_result_link | batches:read | Devuelve un enlace de descarga válido durante 30 minutos para un resultado completado |
update_batch | batches:write | Cambia el nombre de una traducción, la archiva o la restaura |
La herramienta de enlace al resultado devuelve por defecto una URL temporal de descarga. Para formatos de texto de menos de 2 MB, indica format: 'content' para recibir el texto traducido en la respuesta de la herramienta. update_batch solo modifica metadatos de organización y permite revertir el archivado.
Herramientas que traducen
| Tool | Scope | Qué hace |
|---|---|---|
create_upload_url | batches:create | Devuelve una URL temporal y los encabezados para un archivo local. Requiere un cliente HTTP externo. No tiene coste. |
create_translation | batches:create | Crea una traducción a partir de un archivo. No tiene coste. |
plan_translation | batches:create | Define o ajusta en lenguaje sencillo qué se va a traducir. No tiene coste. |
approve_translation | batches:create | Consume créditos e inicia la traducción |
cancel_translation | batches:write | Detiene una traducción en curso; se cobra el trabajo ya realizado |
Estas herramientas marcan la diferencia entre un agente que consulta tu espacio de trabajo y uno que puede hacer el trabajo. La secuencia es fija (crear, planificar, aprobar) y solo el tercer paso tiene coste.
Revisión interactiva con MCP Apps

Tras crear o seleccionar un lote, llama a show_translation con su
batch_id. Los hosts compatibles pueden mostrar el archivo, el plan, el contenido incluido y excluido, los precios calculados de Standard/Lite, el saldo del espacio de trabajo, el progreso y el resultado.
Los demás clientes reciben los datos estructurados habituales del lote y pueden seguir usando las herramientas existentes.
La vista consulta y aprueba a través de la misma conexión MCP autenticada.
Verla y actualizarla no consume créditos. Para aprobar se necesita batches:create,
un plan verificado y vigente, un nivel de calidad incluido en el plan y créditos suficientes.
Las directrices personalizadas no vacías requieren entitlements.custom_guidelines; el
límite es de 2.000 caracteres. El usuario debe aceptar todas las exclusiones indicadas antes
de iniciar la traducción desde la vista.
create_translation (con una instrucción), plan_translation y get_batch
devuelven plan_revision cuando hay un plan disponible para revisión. Pasa ese valor como
expected_plan_revision a approve_translation: el campo es obligatorio y
vincula la aprobación al plan que ha revisado el usuario. Si el plan ha cambiado, se rechaza el inicio con
plan_changed; consulta el nuevo alcance y precio y vuelve a mostrárselos al usuario.
La aprobación mediante REST acepta el mismo campo y sigue funcionando si se omite,
pero en ese caso no se realiza esta comprobación.
La vista actualiza el trabajo activo con un tiempo de espera limitado y solo ofrece la descarga cuando se ha completado. Las muestras se identifican como tales. Si un archivo conservado no está disponible o ha caducado, se indica el error explícitamente; actualizar la vista no puede recuperar bytes eliminados. No se presupone que el host tenga funciones de interfaz que no haya implementado para MCP Apps. La aplicación web de AI Glot sigue disponible como alternativa.
Enviar un documento local
El cliente MCP debe poder leer los bytes del archivo original y enviar una solicitud HTTP PUT fuera de MCP. Conectar un asistente a AI Glot no le da acceso automáticamente a los archivos adjuntos ni a un cliente HTTP. AI Glot Code Mode no puede realizar esta transferencia por sí solo.
- Llama a
create_upload_urlcon elfilenamesin modificar y el valor exacto desize_bytes. - Envía los bytes originales a
upload_urlcon elmethody losheadersdevueltos. El encabezadoAuthorizationes un secreto temporal que solo permite subir el archivo. No lo sustituyas por una clave de API del espacio de trabajo ni por un token OAuth; tampoco sigas redirecciones, lo registres ni se lo muestres al usuario. - Una vez subido el archivo correctamente, llama a
create_translationconupload_idy, de forma opcional,instruction, en la misma conexión de AI Glot. Se acepta exactamente uno de estos valores:upload_id,contentofile_url. Si usasupload_id, omitefilename. - Revisa el plan verificado y
plan.not_included; después, comprueba que el usuario haya autorizado ese plan y el coste en créditos antes de llamar aapprove_translation.
El secreto de carga permite un único intento de PUT durante 10 minutos. Crea la traducción en el plazo de una hora. Si se pierde la respuesta del PUT, prueba primero a llamar a create_translation con el mismo upload_id. Si no se ha completado ninguna carga, crea una sesión nueva. Repetir la creación recupera la misma traducción y nunca aplica implícitamente una instrucción modificada; usa plan_translation para ajustarla. La recuperación mediante upload_id está disponible hasta que se limpia la sesión, como mínimo durante las 24 horas posteriores a su emisión. Guarda el ID del lote para recuperar la traducción del historial más adelante.
Si el entorno de ejecución no puede leer el archivo adjunto local ni enviar solicitudes HTTP PUT, explica la limitación de inmediato. Por ejemplo: «Este asistente puede conectarse a AI Glot, pero no puede enviar este archivo adjunto local. Sube el documento desde la aplicación web de AI Glot, usa la CLI de AI Glot o proporciona un enlace de descarga HTTPS al que AI Glot pueda acceder». No afirmes que el documento se ha subido, no pidas al usuario su clave de API ni apruebes una traducción sin un archivo y un plan verificados.
También se puede enviar como file_url un documento que ya esté alojado en una URL de descarga HTTPS accesible. Los archivos de texto pequeños se pueden enviar directamente como content. Consulta cargas temporales para conocer las reglas de las solicitudes HTTP y de recuperación.
Herramientas del glosario
| Tool | Scope | Qué hace |
|---|---|---|
list_glossaries | glossaries:read | Muestra las combinaciones de idiomas, el número de términos y los límites del plan |
get_glossary | glossaries:read | Consulta todos los términos de un glosario |
edit_glossary_terms | glossaries:write | Crea el glosario si no existe y, después, añade, modifica, elimina o sustituye por completo los términos |
delete_glossary | glossaries:write | Elimina permanentemente un glosario y todos sus términos |
De forma predeterminada, edit_glossary_terms añade términos. replace_all: true elimina todos los términos que no estén en el mapa proporcionado. Las dos herramientas de edición del glosario se marcan como destructivas porque pueden eliminar términos, por lo que los clientes compatibles pueden exigir confirmación.
Recurso de idiomas
Los idiomas disponibles se ofrecen como recurso MCP almacenable en caché:
aiglot://languagesSe ofrece como recurso porque son datos de referencia estáticos. Consúltalo antes de crear un glosario para una combinación de idiomas.
Resultados y errores de las herramientas
Cada herramienta declara un esquema de entrada y devuelve contenido estructurado, además de una representación en texto legible. El servidor estándar no declara esquemas de salida separados. Los errores se devuelven como resultados legibles de la herramienta, con un code estable y una URL de documentación, para que el modelo pueda corregir la solicitud en lugar de tratar un error de negocio como si la conexión MCP no funcionara.
Copia esto en un asistente compatible con MCP después de conectar AI Glot.
Revisa mi cuenta de AI Glot, el saldo de créditos y el uso de los últimos 30 días. Después, enumera las traducciones recientes que hayan fallado o sigan en curso, explica cualquier aspecto inusual y no modifiques ni archives ningún dato.