AI Glot websiteOpen AI Glot
Operando o AI GlotFerramentas MCP padrão
Operando o AI Glot

Ferramentas MCP padrão

Conheça as 18 ferramentas MCP do AI Glot organizadas por tarefa, os escopos necessários, os efeitos colaterais e o recurso de idiomas compatíveis.

O servidor padrão oferece ferramentas organizadas por tarefa, em vez de reproduzir cada endpoint REST individualmente.

Ferramentas de conta e uso

FerramentaEscopoO que faz
get_accountaccount:readConsulta o espaço de trabalho, o plano, os créditos, os limites e os recursos disponíveis
get_credit_balanceaccount:readConsulta o saldo e cada concessão de créditos
get_usageusage:readConsulta os créditos, as palavras e as traduções concluídas ao longo do tempo

Ferramenta de feedback

FerramentaEscopoO que faz
send_feedbackNenhum além da autenticaçãoRegistra comentários em texto livre sobre um resultado inesperado, um comportamento confuso ou algo que você gostaria que funcionasse de outra forma

Use send_feedback quando o problema estiver claro. Descreva a situação, o que aconteceu e o que deveria ter acontecido. Se souber, informe a ação relacionada, o modelo de IA e o harness do agente. Não inclua chaves de API, tokens, URLs assinadas nem o conteúdo integral de arquivos. O uso não custa créditos nem altera uma tradução.

As ferramentas de conta e uso são somente para leitura e não consomem créditos.

Ferramentas de tradução

FerramentaEscopoO que faz
list_batchesbatches:readLista traduções existentes com paginação por cursor
get_batchbatches:readConsulta uma tradução, seu andamento e o plano de revisão atual
show_translationbatches:readExibe a revisão interativa em hosts compatíveis com MCP Apps
get_batch_result_linkbatches:readRetorna um link de download válido por 30 minutos para um resultado concluído
update_batchbatches:writeRenomeia, arquiva ou restaura uma tradução

Por padrão, a ferramenta de link do resultado retorna uma URL temporária de download. Para formatos de texto com menos de 2 MB, informe format: 'content' para receber o texto traduzido na resposta da ferramenta. update_batch altera apenas os metadados administrativos e, ao arquivar, a ação pode ser revertida.

Ferramentas que traduzem

FerramentaEscopoO que faz
create_upload_urlbatches:createRetorna uma URL temporária e os cabeçalhos para um arquivo local. Requer um cliente HTTP externo. Não custa nada.
create_translationbatches:createCria uma tradução a partir de um arquivo. Não custa nada.
plan_translationbatches:createPlaneja ou ajusta o que será traduzido, em linguagem simples. Não custa nada.
approve_translationbatches:createConsome créditos e inicia a tradução
cancel_translationbatches:writeInterrompe uma tradução em andamento; o trabalho já realizado é cobrado

Essas ferramentas fazem a diferença entre um agente que consulta seu espaço de trabalho e outro que consegue executar tarefas. A sequência é fixa (criar, planejar, aprovar), e somente a terceira etapa tem custo.

Revisão interativa com MCP Apps

Revisão de tradução do AI Glot aberta em um chat: o arquivo, o plano e o que permanece inalterado, exibidos por um host de MCP Apps

O cartão de revisão que um host de MCP Apps abre na conversa

Depois de criar ou selecionar um lote, chame show_translation com o batch_id. Hosts compatíveis podem exibir o arquivo, o plano, o conteúdo incluído e excluído, os preços calculados de Standard/Lite, o saldo do espaço de trabalho, o andamento e o resultado. Os outros clientes recebem dados estruturados comuns do lote e podem continuar usando as ferramentas existentes.

A visualização consulta e aprova pela mesma conexão MCP autenticada. Visualizar e atualizar não custa créditos. Para aprovar, é necessário ter batches:create, um plano atual verificado, um nível de qualidade autorizado e créditos suficientes. Diretrizes personalizadas não vazias exigem entitlements.custom_guidelines; o limite máximo é de 2.000 caracteres. Antes de iniciar pela visualização, o usuário precisa aceitar todas as exclusões listadas.

create_translation (com uma instrução), plan_translation e get_batch retornam plan_revision quando há um plano disponível para revisão. Passe esse valor em expected_plan_revision para approve_translation: o campo é obrigatório e vincula a aprovação ao plano que o usuário revisou. Se o plano tiver mudado desde então, plan_changed impede o início; consulte o novo escopo e preço e mostre-os novamente ao usuário. A aprovação REST aceita o mesmo campo e continua funcionando sem ele, mas, nesse caso, essa verificação é ignorada.

A visualização atualiza o trabalho ativo enquanto aguarda por um período limitado e só oferece o download quando a tarefa é concluída. Uma amostra é identificada como amostra. Se o arquivo mantido tiver sido removido ou expirado, isso será indicado como erro explícito; atualizar não recria bytes excluídos. Não se presume que o host tenha recursos de interface se ele não implementar MCP Apps. O app web do AI Glot continua disponível como alternativa.

Enviar um documento local

O cliente MCP precisa conseguir ler os bytes do arquivo original e fazer uma solicitação HTTP PUT fora do MCP. Conectar um assistente ao AI Glot não dá acesso automático aos anexos nem a um cliente HTTP. O AI Glot Code Mode não consegue realizar essa transferência.

  1. Chame create_upload_url com o filename sem modificações e o size_bytes exato.
  2. Envie os bytes originais para upload_url, usando o method e os headers retornados. O cabeçalho Authorization é um segredo temporário exclusivo para o envio. Nunca o substitua por uma chave de API do espaço de trabalho ou um token OAuth, siga redirecionamentos, registre-o em logs ou mostre-o ao usuário.
  3. Após o envio ser concluído com sucesso, chame create_translation na mesma conexão do AI Glot, passando upload_id e, opcionalmente, instruction. Só é aceito um dos valores entre upload_id, content e file_url. Se usar upload_id, omita filename.
  4. Revise o plano verificado e plan.not_included e, antes de chamar approve_translation, confirme que o usuário autorizou esse plano e o custo em créditos.

O segredo de envio permite uma única tentativa de PUT em até 10 minutos. Crie a tradução em até uma hora. Se a resposta do PUT for perdida, tente primeiro create_translation com o mesmo upload_id. Se não houver um envio completo, obtenha uma nova sessão. Repetir a criação recupera a mesma tradução e nunca aplica implicitamente uma instrução alterada; use plan_translation para ajustá-la. A recuperação por upload_id fica disponível até a limpeza da sessão, no mínimo 24 horas após a emissão. Guarde o ID do lote para recuperar a tradução do histórico mais tarde.

Se o ambiente de execução não conseguir ler o anexo local ou enviar solicitações HTTP PUT, explique a limitação imediatamente. Por exemplo: “Este assistente pode se conectar ao AI Glot, mas não consegue enviar este anexo local. Envie o documento pelo app web do AI Glot, use a CLI do AI Glot ou forneça um link de download HTTPS que o AI Glot possa acessar.” Não afirme que o documento foi enviado, não peça a chave de API do usuário e não aprove uma tradução sem um arquivo e um plano verificados.

Um documento que já esteja hospedado em uma URL de download HTTPS acessível ainda pode ser enviado como file_url. Arquivos de texto pequenos podem ser enviados integralmente como content. Consulte envios temporários para ver as regras de solicitação HTTP e recuperação.

Ferramentas de glossário

FerramentaEscopoO que faz
list_glossariesglossaries:readLista pares de idiomas, contagem de termos e limites do plano
get_glossaryglossaries:readConsulta todos os termos de um glossário
edit_glossary_termsglossaries:writeCria o glossário se ele não existir e, em seguida, adiciona, altera, remove ou substitui todos os termos
delete_glossaryglossaries:writeExclui permanentemente um glossário e todos os seus termos

Por padrão, edit_glossary_terms adiciona termos. replace_all: true exclui todos os termos que não constarem no mapa fornecido. As duas ferramentas de edição do glossário são marcadas como destrutivas porque podem remover termos; por isso, clientes compatíveis podem exigir confirmação.

Recurso de idiomas

Os idiomas compatíveis são disponibilizados como o recurso MCP armazenável em cache:

aiglot://languages

Esse recurso é disponibilizado porque contém dados estáticos de referência. Consulte-o antes de criar um glossário para um par de idiomas.

Resultados e erros das ferramentas

Cada ferramenta declara um esquema de entrada e retorna conteúdo estruturado, além de uma representação em texto legível. O servidor padrão não declara esquemas de saída separados. Erros são retornados como resultados legíveis da ferramenta, com um code estável e uma URL de documentação, permitindo que o modelo corrija a solicitação em vez de interpretar um erro de negócio como uma falha de conexão MCP.

Auditar meu uso recente de traduções

Copie isto para um assistente compatível com MCP após conectar o AI Glot.

Revise minha conta do AI Glot, meu saldo de créditos e o uso nos últimos 30 dias. Em seguida, liste as traduções recentes que falharam ou ainda estão em andamento, explique qualquer atividade incomum e não modifique nem arquive nenhum dado.

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.