# Glossa

> Glossa is an AI-native translation management system: push any translation file, get every language translated by Claude, dedupe strings across apps, and let agents review, audit and improve your translations over MCP, CLI and API.

Glossa is made by Meter. Every dashboard action is an op, available as REST (`POST https://glossa-meterapp.vercel.app/api/v1/{op}`), as an MCP tool (https://glossa-meterapp.vercel.app/api/mcp, streamable HTTP) and as a CLI command (`npx @meterapp/glossa <op>`). Authenticate with `Authorization: Bearer gls_…` (a workspace API key) or OAuth on the MCP endpoint.

## Docs

- [Overview](https://glossa-meterapp.vercel.app/docs): What Glossa is, its concepts and every way to drive it.
- [Quickstart](https://glossa-meterapp.vercel.app/docs/quickstart): Push your first file, get it translated and pull every locale back in five minutes.
- [CLI](https://glossa-meterapp.vercel.app/docs/cli): Push, pull and run any op from a terminal or CI with the Glossa CLI.
- [MCP and agent plugins](https://glossa-meterapp.vercel.app/docs/mcp): Connect Claude Code, Codex, Cursor and any MCP client to Glossa.
- [REST API reference](https://glossa-meterapp.vercel.app/docs/api): Every op, its input schema and a curl example, generated from the ops registry.
- [Errors](https://glossa-meterapp.vercel.app/docs/errors): RFC 9457 problem responses and every error code the API returns.
- [File formats](https://glossa-meterapp.vercel.app/docs/formats): Built-in formats, how plurals and placeholders round-trip, and how unknown formats are learned.
- [Review queue](https://glossa-meterapp.vercel.app/docs/review-queue): Merge reviews, low-confidence translations, audit findings and suggested rules, built for agents to work through.
- [Audits, glossary and rules](https://glossa-meterapp.vercel.app/docs/audits-and-rules): Ask how a language is doing, turn the findings into fixes and make every future translation better.

## Machine-readable

- [agents.md](https://glossa-meterapp.vercel.app/agents.md): Concise guide for coding agents: auth, ops, workflows and rules.
- [llms-full.txt](https://glossa-meterapp.vercel.app/llms-full.txt): Everything in one file, including every op's JSON input schema.
- [OpenAPI 3.1](https://glossa-meterapp.vercel.app/openapi.json): Every op as POST /api/v1/{op}.
- [Op catalog](https://glossa-meterapp.vercel.app/api/v1): JSON list of every op with its input schema.
- [MCP server card](https://glossa-meterapp.vercel.app/.well-known/mcp.json)
- [OAuth protected resource metadata](https://glossa-meterapp.vercel.app/.well-known/oauth-protected-resource)

## Ops

- `get_workspace` (read): Get workspace. The workspace this credential belongs to: name, source locale and the product context every AI prompt starts with.
- `update_workspace` (write): Update workspace. Change the workspace name, source locale or product context.
- `get_stats` (read): Get stats. Counts across the workspace (projects, units, keys, open tasks) and per-locale translation coverage per project.
- `list_activity` (read): List activity. Who changed what, from which surface (dashboard, api, mcp, cli, ai), newest first.
- `list_projects` (read): List projects. Every project (app) in the workspace with its target locales.
- `create_project` (write): Create project. Add a project (one app, site or service) with the locales it ships in.
- `update_project` (write): Update project. Change a project's name, description, target locales or auto-translate.
- `list_files` (read): List files. Files of a project.
- `push_file` (write): Push file. Upload a translation file in any format (JSON, YAML, xcstrings, .strings, stringsdict, strings.xml, PO, XLIFF, ARB, properties, RESX, CSV, or one Glossa learned).
- `pull_file` (read): Pull file. Render one locale of a file in its own format, ready to write to disk.
- `detect_format` (read): Detect format. Which format Glossa would read a file as, with confidence and the runner-up candidates.
- `list_formats` (read): List formats. Built-in formats and the templates this workspace has learned, with their status.
- `learn_format` (write): Learn format. Ask the AI to write a template for a file format Glossa can't read yet, from a sample.
- `approve_format` (write): Save or retire a format. Set a learned format's status (active reads files, retired stops).
- `search_units` (read): Search strings. Full-text and fuzzy search across every source string, key name and translation in the workspace.
- `list_units` (read): List strings. Page through units (deduplicated source strings) with their translation in one locale.
- `get_unit` (read): Get string. One unit with every key that uses it (across projects and files), all its translations and their history.
- `update_unit` (write): Update string context. Set a unit's description (context for translators and the AI), max length or tags.
- `set_translation` (write): Set translation. Write or correct a unit's translation in one locale.
- `review_translations` (write): Review translations. Mark many translations reviewed, approved or needs_review at once, by unit and locale.
- `translate` (write): Translate. Queue AI translation.
- `merge_units` (write): Merge strings. Point every key of the `merge` units at the `into` unit, so they share one translation per locale.
- `split_key` (write): Split key. Give one key its own unit (a copy of the source and its translations) so it can be translated differently from the other keys that shared the string.
- `scan_duplicates` (write): Scan for near-duplicates. Queue a scan for near-duplicate strings (same meaning, slightly different text) and file merge_suggestion tasks for them.
- `list_tasks` (read): List review tasks. The review queue, highest priority first.
- `claim_tasks` (write): Claim review tasks. Claim up to `limit` open tasks so parallel agents don't work the same ones.
- `resolve_task` (write): Resolve review task. Decide a task by naming one of its actions (merge_review: keep_merged | split; merge_suggestion: merge_into_a | merge_into_b | keep_separate; learn_format: keep | retire | retry_with_hint | dismiss; translation_review: approve | edit | retranslate; audit_finding: apply | edit | dismiss; rule_suggestion: add | edit | dismiss; glossary_suggestion: add | dismiss).
- `list_glossary` (read): List glossary. Glossary terms: brand and product names that are never translated, and terms with a fixed translation per locale.
- `upsert_glossary_term` (write): Add or update glossary term. Add a term or change it.
- `delete_glossary_term` (write): Delete glossary term. Remove a glossary term; future translations no longer enforce it.
- `list_rules` (read): List translation rules. Standing instructions appended to every translation prompt, globally or for one locale.
- `add_rule` (write): Add translation rule. Add a standing instruction for future translations, e.g.
- `update_rule` (write): Update translation rule. Edit a translation rule's text, or set active=false to stop adding it to translation prompts.
- `run_audit` (write): Run audit. Ask the AI to review one locale holistically ("How is our Spanish?
- `get_audit` (read): Get audit. An audit's answer, score and findings (empty while its job runs; see job_status).
- `list_audits` (read): List audits. Past locale audits with their summary and score, newest first.
- `get_job` (read): Get job. Status and output of a background job (translate, learn_format, audit, dedupe_scan).
- `list_jobs` (read): List jobs. Recent background jobs (translate, learn_format, audit, dedupe_scan) with status and errors, newest first.
- `list_api_keys` (read): List API keys. API keys of this workspace (prefix only; the full key is shown once at creation).
- `create_api_key` (write): Create API key. Create a workspace API key for the CLI, MCP or CI.
- `revoke_api_key` (write): Revoke API key. Revoke an API key immediately; every CLI, CI job or MCP host using it stops working.
- `get_pricing` (read): Get pricing. The plans (Free, Pro, Team, Enterprise) with monthly and yearly prices in cents, AI translations included a month, member and project limits, features, and how to buy.
- `get_billing` (read): Get billing. This workspace's plan, subscription status, renewal or end date, whether a card is saved (so subscribe can charge it), and usage this month against the plan (AI translations, members, projects).
- `create_checkout_link` (write): Create checkout link. A Stripe Checkout URL where a human pays for a plan; hand it to them (or open it in their browser).
- `subscribe` (write): Subscribe. Start or change this workspace's paid plan in one call, charging the card already saved for the workspace.
- `cancel_subscription` (write): Cancel subscription. Cancel the paid plan at the end of the current period (no refund; the plan stays until then, then the workspace is on Free).
- `resume_subscription` (write): Resume subscription. Undo a cancellation that has not taken effect yet, so the plan renews as before.
- `create_billing_portal_link` (write): Create billing portal link. A private Stripe page where a human downloads invoices, updates the card or billing details, or cancels.

## Pricing

Unit: AI translation: one source string translated into one locale by Claude. Imports and human or agent edits are free. Yearly is two months free. Full price list without a credential: `GET https://glossa-meterapp.vercel.app/api/v1/get_pricing`; human page: https://glossa-meterapp.vercel.app/pricing.

- Free (`free`): free. 2,000 AI translations a month, 3 members, 3 projects. For trying Glossa on one app.
- Pro (`pro`): $49/month or $490/year. 25,000 AI translations a month, 10 members, unlimited projects. For a product team shipping in many languages.
- Team (`team`): $199/month or $1,990/year. 150,000 AI translations a month, unlimited members, unlimited projects. For companies localizing several apps and sites.
- Enterprise (`enterprise`): custom. Volume AI translations a month, unlimited members, unlimited projects. For larger volumes, security reviews and invoicing.

Buying a plan:

- create_checkout_link {plan, interval} returns a Stripe Checkout URL; give it to a human to pay. Nothing is charged until they complete it.
- subscribe {plan, interval, confirm: true} starts or changes the plan on the card already saved for this workspace, after a human approved the price. Without a saved card it returns a checkout_url instead.
- get_billing shows the current plan, usage this month and whether a card is saved.
- CLI: `npx @meterapp/glossa pricing`, `npx @meterapp/glossa billing`, `npx @meterapp/glossa subscribe pro --interval year [--open]`.

## Formats

- [Xcode String Catalog](https://glossa-meterapp.vercel.app/formats/xcstrings): .xcstrings (all locales in one file)
- [Flutter ARB](https://glossa-meterapp.vercel.app/formats/arb): .arb
- [JSON (key/value, i18next)](https://glossa-meterapp.vercel.app/formats/json): .json
- [YAML (Rails i18n)](https://glossa-meterapp.vercel.app/formats/yaml): .yml, .yaml
- [Apple .strings](https://glossa-meterapp.vercel.app/formats/ios-strings): .strings
- [Apple .stringsdict](https://glossa-meterapp.vercel.app/formats/ios-stringsdict): .stringsdict
- [Android strings.xml](https://glossa-meterapp.vercel.app/formats/android-xml): .xml
- [Gettext PO/POT](https://glossa-meterapp.vercel.app/formats/gettext-po): .po, .pot
- [XLIFF 1.2 / 2.0](https://glossa-meterapp.vercel.app/formats/xliff): .xlf, .xliff (all locales in one file)
- [Java .properties](https://glossa-meterapp.vercel.app/formats/properties): .properties
- [.NET RESX](https://glossa-meterapp.vercel.app/formats/resx): .resx
- [CSV / TSV (multi-locale)](https://glossa-meterapp.vercel.app/formats/csv): .csv, .tsv (all locales in one file)

## Optional

- [Home](https://glossa-meterapp.vercel.app/): Localization your AI agents can run.
- [Pricing](https://glossa-meterapp.vercel.app/pricing): Free for one app; Pro and Team priced by AI translations, not seats.
- [Glossa vs Crowdin](https://glossa-meterapp.vercel.app/compare/crowdin): How Glossa compares with Crowdin, feature by feature.
- [Formats](https://glossa-meterapp.vercel.app/formats): Every translation file format Glossa supports.
- [Built for agents](https://glossa-meterapp.vercel.app/agents): MCP, CLI, REST and plugins for coding agents.