API Reference
Complete API reference for Better i18n MCP tools and REST endpoints.
Better i18n provides two main APIs:
- MCP Tools - For AI assistants (Claude, Cursor, etc.)
- REST API - For direct integrations
MCP Tools
The MCP (Model Context Protocol) server exposes these tools for AI-powered translation management:
| Tool | Description |
|---|---|
| listProjects | List all projects you have access to |
| getProject | Get project details including languages and namespaces |
| addLanguage | Add a new target language to a project |
| listKeys | Get translation keys with search and filters |
| createKeys | Create new translation keys |
| updateKeys | Update translations for existing keys |
| deleteKeys | Soft-delete translation keys |
| getSyncs | List recent sync operations |
| getSync | Get details of a specific sync |
Authentication
All API calls require an API key. Get yours from the dashboard.
# For MCP Server
export BETTER_I18N_API_KEY="your-api-key"
# For REST API
curl -H "Authorization: Bearer your-api-key" \
https://dash.better-i18n.com/api/...Project Identifier
Most tools require a project parameter in org/project format:
{
"project": "my-org/my-project"
}You can find this in your project's i18n.ts config file.