Standard MCP tools
Understand the 16 task-shaped AI Glot MCP tools, their required scopes, side effects and the supported-language resource.
The standard server exposes task-shaped tools rather than copying every REST endpoint one for one.
Account and usage tools
| Tool | Scope | What it does |
|---|---|---|
get_account | account:read | Reads workspace, plan, credits, limits and capabilities |
get_credit_balance | account:read | Reads balance and every credit grant |
get_usage | usage:read | Reads credits, words and completed translations over time |
Feedback tool
| Tool | Scope | What it does |
|---|---|---|
send_feedback | None beyond authentication | Records open-text feedback about an unexpected result, confusing behaviour or something you wish worked differently |
Use send_feedback once the issue is clear. Include the situation, what happened and what should have happened. If known, add the related action, AI model and agent harness. Do not include API keys, tokens, signed URLs or full file contents. It costs no credits and does not change a translation.
These tools are read-only and consume no credits.
Translation tools
| Tool | Scope | What it does |
|---|---|---|
list_batches | batches:read | Lists existing translations with cursor pagination |
get_batch | batches:read | Reads one translation and its progress |
get_batch_result_link | batches:read | Returns a 30-minute download link for a completed result |
update_batch | batches:write | Renames, archives or restores a translation |
The result-link tool returns a URL, never raw file content. update_batch changes housekeeping metadata only and is reversible when archiving.
Tools that translate
| Tool | Scope | What it does |
|---|---|---|
create_translation | batches:create | Creates a translation from a file. Costs nothing. |
plan_translation | batches:create | Plans or refines what to translate, in plain language. Costs nothing. |
approve_translation | batches:create | Spends credits and starts the translation |
cancel_translation | batches:write | Stops a running translation; work already done is charged |
These four are the difference between an agent that reads your workspace and one that can do the work. The sequence is fixed (create, plan, approve), and only the third step costs anything.
Glossary tools
| Tool | Scope | What it does |
|---|---|---|
list_glossaries | glossaries:read | Lists language pairs, term counts and plan limits |
get_glossary | glossaries:read | Reads every term in one glossary |
edit_glossary_terms | glossaries:write | Creates if missing, then adds, changes, removes or fully replaces terms |
delete_glossary | glossaries:write | Permanently deletes a glossary and all its terms |
edit_glossary_terms is additive by default. replace_all: true deletes every term absent from the supplied map. delete_glossary is explicitly marked destructive so supporting clients can require confirmation.
Language resource
Supported languages are exposed as the cacheable MCP resource:
aiglot://languagesIt is a resource rather than a sixteenth tool because it is static reference data. Read it before creating a language-pair glossary.
Tool results and errors
Every tool has an input and output schema and returns structured content. Errors are returned as readable tool results with a stable code and documentation URL, allowing the model to correct the request instead of treating a business error as a broken MCP connection.
Copy this into an MCP-enabled assistant after connecting AI Glot.
Review my AI Glot account, credit balance and the last 30 days of usage. Then list recent failed or still-running translations, explain anything unusual, and do not modify or archive any data.