MCP Tools Reference

All tools are available once you've connected and authenticated. Each tool maps closely to a REST API endpoint, but you describe what you want in plain language and your AI assistant calls the right tool.

list_hives

Lists all Hives your token has access to.

Returns: name, slug, source locale, string count, target locales for each Hive.

Example prompt: "What Hives do I have access to?"

hive_stats

Returns translation completion percentages per locale for a specific Hive.

Parameters: hive (the Hive slug)

Returns: total string count, per-locale translated and approved counts.

Example prompt: "How complete is the German translation in my-app?"

list_strings

Browse or search source strings in a Hive.

Parameters: hive, optional search query (searches keys and values)

Returns: key, source value, plural flag, file for each matching string.

Example prompt: "Show me all strings in the auth.php file of my-app."

push_strings

Add or update source strings in a Hive. This is what you'd use after adding new features with translatable text.

Parameters: hive, strings (flat key-value object), file (the filename to namespace them under), optional conflict_strategy (keep or clear)

Returns: created, updated, unchanged, and translations_cleared counts.

Example prompt: "Push these new strings to the my-app hive in auth.php: login.title = 'Sign in to your account', login.subtitle = 'Welcome back'."

pull_translations

Export translated strings for one or all locales.

Parameters: hive, optional locale, optional format (json or php)

Returns: a files object with filenames and their content.

Example prompt: "Pull the German translations from my-app and write them to the lang/de directory."

import_translations

Push translated strings for a specific locale into Stringhive.

Parameters: hive, locale, files (filename to key-value translation objects), optional overwrite_strategy (skip or overwrite)

Returns: created, updated, skipped, and unknown counts.

Example prompt: "Import the French translations from my local fr.json into the my-app hive."

list_locales

Returns all locales supported by Stringhive with their codes, names, and RTL flags.

Example prompt: "What locale code should I use for Traditional Chinese?"