mcp

List Keys With Translations

LLM-friendly bulk view: keys + source value + per-language translations.

The tools.list_keys MCP tool wraps this. One round-trip lets Claude decide which keys still need translations and what the source text is.

get/v1/mcp/projects/{project_id}/keys

Request

  • Base URL: https://api.sonenta.dev
  • URL: https://api.sonenta.dev/v1/mcp/projects/{project_id}/keys
  • Auth: none declared

Path parameters

project_idstring required

Query parameters

namespacestring nullable

Filter by namespace slug

name_prefixstring nullable

Filter to keys whose name starts with this prefix (case-sensitive, namespace-agnostic). Lets an agent pull just the keys under a dotted path (e.g. 'checkout.') instead of the whole namespace.

key_uuidsstring[] nullable

Fetch specific keys by UUID (repeat the param, or pass a comma-separated list). Bypasses namespace/prefix scoping for a targeted per-key context check. Combinable with cursor for paging.

language_codestring nullable

Restrict the per-key translations[] to a single BCP-47 language code. Omit to include all project languages.

status_filterstring nullable

Include only keys that have at least one translation with this status (missing|draft|translated|reviewed|approved). When language_code is also set, the filter applies to that language only.

cursorstring nullable
limitinteger
include_glossary_hintsboolean

Attach per-key glossary_hints[] (target_translation uses language_code when set).

Response

Successful Response

cursor_nextstring nullable required
totalinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.