Skip to content

MCP tools (@sonenta/mcp)

The 60 MCP tools exposed by @sonenta/mcp (v0.46.2), callable by AI agents (ApiKey auth, mcp:* scope). Auto-generated from source.

  • list_projects - List projects accessible to the configured Sonenta API key.
  • get_project_info - Fetch a project's metadata: source language, all configured languages, namespaces, key count.
  • distribution_info - Get the project's CDN distribution status: the public CDN base URL + bundle URL template, the production…
  • sonenta_guide - Get the Sonenta usage guide: a concise, up-to-date overview of how this Sonenta instance works - core…
  • list_keys - List translation keys with their source-language value, their semantic type, and per-language translations.
  • list_untranslated_keys - List keys that DON'T yet have a valid translation in the target language.
  • list_missing_keys - List pending missing-key events captured from the SDK runtime. Cursor paginated (default page = 50).
  • missing_keys_stats - Count-only summary of missing-key events for a project.
  • acknowledge_missing_keys - Batch-resolve a set of missing-event uuids.
  • create_namespace - Create a namespace (the container for keys).
  • create_key - Create a translation key, idempotent on (namespace, name). Returns created=false if the key already exists.
  • propose_translation - Submit a translation value. Auto-creates the key if it doesn't exist (write-through).
  • create_keys_bulk - Batch version of create_key: create up to 500 keys in one call, idempotent per item (existing keys return…
  • update_key - Edit a key in place - its SOURCE-language value, its type, and/or its description (pass at least one).
  • update_keys_bulk - Batch version of update_key: edit up to 500 keys' SOURCE values in one call.
  • propose_translations_bulk - Batch version of propose_translation: submit up to 500 translation values in one call.
  • publish_cdn - Trigger a CDN release for the project. Builds bundles for every (language, namespace) combo (or restricted to…
  • validate_translations - Lint a JSON i18next blob against the project: checks for missing keys, extra keys, and placeholder parity…
  • project_context_get - Read the project's markdown context document.
  • project_context_set - Upsert the project's markdown context document.
  • glossary_list - List a project's glossary entries - the terminology rules the backend applies when matching source strings.
  • glossary_create - Create a glossary entry. rule_type is one of translation | do_not_translate | forbidden and defaults to…
  • glossary_update - Update a glossary entry by its uuid (entry_id).
  • glossary_delete - Delete a glossary entry by its uuid (entry_id). Returns {deleted: true, entry_id}.
  • health_report - Read-only SOURCE-HEALTH report for the project (#752): issues in the source strings with by_issue /…
  • coverage_report - Read-only translation-COVERAGE report for the project (#752): global completeness, total key count, and…
  • delete_keys_bulk - Soft-delete (move to TRASH) up to 500 keys by their key_uuid. Restorable via restore_keys_bulk.
  • restore_keys_bulk - Restore up to 500 trashed keys by their key_uuid (from list_trash).
  • list_trash - List trashed (soft-deleted) keys: items of {key_uuid, namespace, name, deleted_at}, cursor-paginated.
  • a11y_estimate - Preview the CREDIT cost of an a11y generate/translate run BEFORE spending anything (task 990).
  • generate_a11y_variant - AI-generate SOURCE-language a11y variants for keys that lack them (task 990).
  • translate_a11y_variants - Translate EXISTING source-language a11y overrides into target locales (task 990).
  • a11y_report - Read-only WCAG ACCESSIBILITY quality report for the project (task 991): per key/surface/locale a11y gaps with…
  • list_a11y_gaps - List the actionable a11y gaps (the items[] of a11y_report, task 991), optionally filtered client-side.
  • set_a11y_variant - Upsert ONE a11y variant override for (key, language, surface) - the manual fix for a gap (a11y V1).
  • delete_a11y_variant - Delete ONE a11y variant override for (key, language, surface) (a11y V1).
  • list_surfaces - List the project's configurable SURFACES (task 928): the device and a11y surfaces variants can be authored…
  • create_surface - Create a CUSTOM DEVICE surface for the project (task 928), e.g. 'watch', 'tv', 'kiosk'.
  • update_surface - Rename and/or toggle a surface (task 928): set its label and/or active.
  • delete_surface - Delete a CUSTOM surface (task 928). Builtins cannot be deleted - deactivate them with…
  • recommend_surfaces - Read-only per-key A11Y SURFACE RECOMMENDATIONS (#2): for each key, the a11y surfaces implied by its semantic…
  • surface_coverage - Read-only COVERAGE BY SURFACE (#3): per active surface, how complete it is.
  • get_variants - Read the full VARIANT MATRIX for one key (task 928): every surface OFFERED for the key x every project…
  • set_variant - Upsert ONE variant override for (key, language, surface) for ANY surface active on the project (task 928) - …
  • delete_variant - Delete ONE variant override for (key, language, surface), for ANY surface (device or a11y) - task 928.
  • list_cognitive_candidates - List keys that are CANDIDATES for plain-language (cognitive) scoring: text-relevant keys (a type that offers…
  • set_cognitive_score - Record a key's cognitive-difficulty SCORE (0-100, higher = harder to read) and an optional plain-language…
  • analyze_cognitive - Server-side AI cognitive analysis - the BILLED, opt-in FALLBACK to local scoring.
  • wcag_report - WCAG 2.2 content-layer measurement, per success criterion and per locale.
  • eaa_statement - EAA / EN 301 549 content-layer accessibility report (JSON).
  • list_a11y_review_queue - Read the a11y REVIEW QUEUE - the per-(key, locale, surface) review items with their state.
  • a11y_remediation_plan_get - Read the a11y REMEDIATION PLAN for the project (or null if none exists).
  • a11y_remediation_plan_apply - EXECUTE the APPROVED a11y remediation plan - the agent's bulk-execute entrypoint.
  • score_cognitive_local - Compute and persist cognitive-difficulty scores from a VALIDATED, deterministic READABILITY metric - the…
  • list_placeholder_mismatches - List TRANSLATIONS whose interpolation VARIABLES drift from their source value (Placeholder mismatch, PM2) - a…
  • list_source_duplicates - List groups of keys that SHARE an identical source-language value (Source Health duplicates, #1116).
  • set_duplicate_status - Set the triage STATUS of one duplicate group, addressed by its shared source_value (Source Health duplicates,…
  • set_source_duplicate_merge_plan - AUTHOR (or clear) the merge plan for one duplicate group, addressed by its shared source_value (Source Health…
  • mark_cluster_applied - Mark ONE cluster of a duplicate group's merge plan as APPLIED - addressed by the group's source_value + the…
  • apply_new_key_cluster - Consolidate a duplicate group onto a BRAND-NEW canonical key (NK1) - the BACKEND does the atomic data…