AI Glot websiteOpen AI Glot
Operar AI GlotHerramientas MCP estándar
Operar AI Glot

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

ToolScopeQué hace
get_accountaccount:readConsulta el espacio de trabajo, el plan, los créditos, los límites y las funciones disponibles
get_credit_balanceaccount:readConsulta el saldo y cada una de las asignaciones de crédito
get_usageusage:readConsulta los créditos, las palabras y las traducciones completadas a lo largo del tiempo

Herramienta para enviar comentarios

ToolScopeQué hace
send_feedbackNone beyond authenticationRegistra 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

ToolScopeQué hace
list_batchesbatches:readMuestra las traducciones existentes mediante paginación por cursor
get_batchbatches:readConsulta una traducción, su progreso y el plan de revisión actual
show_translationbatches:readMuestra la revisión interactiva en los hosts compatibles con MCP Apps
get_batch_result_linkbatches:readDevuelve un enlace de descarga válido durante 30 minutos para un resultado completado
update_batchbatches:writeCambia 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

ToolScopeQué hace
create_upload_urlbatches:createDevuelve una URL temporal y los encabezados para un archivo local. Requiere un cliente HTTP externo. No tiene coste.
create_translationbatches:createCrea una traducción a partir de un archivo. No tiene coste.
plan_translationbatches:createDefine o ajusta en lenguaje sencillo qué se va a traducir. No tiene coste.
approve_translationbatches:createConsume créditos e inicia la traducción
cancel_translationbatches:writeDetiene 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

Revisión de una traducción de AI Glot abierta en un chat: el archivo, el plan y el contenido que no se modifica, mostrados por un host de MCP Apps

La tarjeta de revisión que un host de MCP Apps abre en la conversación

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.

  1. Llama a create_upload_url con el filename sin modificar y el valor exacto de size_bytes.
  2. Envía los bytes originales a upload_url con el method y los headers devueltos. El encabezado Authorization es 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.
  3. Una vez subido el archivo correctamente, llama a create_translation con upload_id y, de forma opcional, instruction, en la misma conexión de AI Glot. Se acepta exactamente uno de estos valores: upload_id, content o file_url. Si usas upload_id, omite filename.
  4. 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 a approve_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

ToolScopeQué hace
list_glossariesglossaries:readMuestra las combinaciones de idiomas, el número de términos y los límites del plan
get_glossaryglossaries:readConsulta todos los términos de un glosario
edit_glossary_termsglossaries:writeCrea el glosario si no existe y, después, añade, modifica, elimina o sustituye por completo los términos
delete_glossaryglossaries:writeElimina 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://languages

Se 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.

Revisa el uso reciente de mis traducciones

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.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.