# Oss

> Official TypeScript SDKs for Better i18n — Next.js, React, Expo/React Native integrations with CLI, MCP server, and CDN-powered translation delivery

- **Type:** MCP server
- **Install:** `agentstack add mcp-better-i18n-oss`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [better-i18n](https://agentstack.voostack.com/s/better-i18n)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [better-i18n](https://github.com/better-i18n)
- **Source:** https://github.com/better-i18n/oss
- **Website:** https://better-i18n.com/

## Install

```sh
agentstack add mcp-better-i18n-oss
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

TypeScript SDKs for the Better i18n localization platform

  Manage translations with CDN delivery, GitHub sync, and AI-powered workflows.
  
  Documentation · Website · Blog

  
  
  
  
  

---

## Why Better i18n?

Most localization tools weren't built for modern developer workflows. Better i18n is different:

- **GitHub-native** — translations sync as PRs, reviews happen in your existing workflow
- **CDN-delivered** — translations served from [Cloudflare's edge network](https://cloudflare.com), updated without redeployment
- **AI-powered** — context-aware translation with [Google Gemini](https://deepmind.google/technologies/gemini/), not word-by-word machine output
- **TypeScript-first** — full type safety across [Next.js](https://nextjs.org), [React](https://react.dev), [Expo](https://expo.dev), and [React Native](https://reactnative.dev)
- **MCP-ready** — AI agents can manage translations through the [Model Context Protocol](https://modelcontextprotocol.io/)

### How it compares

| Feature | Better i18n | [Crowdin](https://crowdin.com) | [Lokalise](https://lokalise.com) | [Phrase](https://phrase.com) |
|---------|:-----------:|:------:|:--------:|:------:|
| GitHub-first workflow | ✅ | Partial | Partial | ❌ |
| AI translation with context | ✅ | ✅ | ✅ | ✅ |
| CDN delivery (no redeploy) | ✅ | ❌ | ❌ | ❌ |
| TypeScript SDKs | ✅ | ❌ | ❌ | ❌ |
| MCP server for AI agents | ✅ | ❌ | ❌ | ❌ |
| CLI scanner (unused key detection) | ✅ | ❌ | ❌ | ❌ |
| ICU MessageFormat support | ✅ | ✅ | ✅ | ✅ |
| Open-source SDKs | ✅ | Partial | ❌ | ❌ |
| Free tier | ✅ | ✅ | ❌ | ❌ |

## Packages

| Package | Description | Version |
|---------|-------------|---------|
| [`@better-i18n/cli`](./packages/cli) | CLI for scanning, syncing, and managing translations | [](https://www.npmjs.com/package/@better-i18n/cli) |
| [`@better-i18n/next`](./packages/next) | [Next.js](https://nextjs.org) SDK with middleware and hooks | [](https://www.npmjs.com/package/@better-i18n/next) |
| [`@better-i18n/use-intl`](./packages/use-intl) | [React](https://react.dev) hooks for [use-intl](https://www.npmjs.com/package/use-intl) integration | [](https://www.npmjs.com/package/@better-i18n/use-intl) |
| [`@better-i18n/expo`](./packages/expo) | [Expo](https://expo.dev) / [React Native](https://reactnative.dev) integration with offline caching | [](https://www.npmjs.com/package/@better-i18n/expo) |
| [`@better-i18n/core`](./packages/core) | Core utilities for locale handling and formatting | [](https://www.npmjs.com/package/@better-i18n/core) |
| [`@better-i18n/mcp`](./packages/mcp) | [MCP](https://modelcontextprotocol.io/) server for AI agent integration | [](https://www.npmjs.com/package/@better-i18n/mcp) |
| [`@better-i18n/schemas`](./packages/schemas) | Shared [Zod](https://zod.dev) validation schemas | [](https://www.npmjs.com/package/@better-i18n/schemas) |

## Quick Start

```bash
# Install the CLI
npm install -g @better-i18n/cli

# Initialize in your project
npx @better-i18n/cli init

# Scan your codebase for translation keys
npx @better-i18n/cli scan

# Sync translations with the Better i18n platform
npx @better-i18n/cli sync
```

## Framework Integration

### Next.js

```bash
npm install @better-i18n/next
```

```typescript
// middleware.ts
import { createI18nMiddleware } from '@better-i18n/next';

export default createI18nMiddleware({
  locales: ['en', 'tr', 'de'],
  defaultLocale: 'en',
});
```

See the [Next.js integration guide](https://docs.better-i18n.com/sdk/next) for routing, server components, and metadata setup.

### React with use-intl

```bash
npm install @better-i18n/use-intl
```

```tsx
import { BetterI18nProvider, useTranslations } from '@better-i18n/use-intl';

function App() {
  return (
    
      
    
  );
}

function MyComponent() {
  const t = useTranslations('common');
  return {t('welcome')};
}
```

### Expo / React Native

```bash
npm install @better-i18n/expo
```

```tsx
import { BetterI18nExpoProvider, useTranslations } from '@better-i18n/expo';

export default function App() {
  return (
    
      
    
  );
}
```

Supports offline caching, OTA translation updates, and automatic locale detection. See the [Expo guide](https://docs.better-i18n.com/sdk/expo).

### MCP Server (AI Agents)

```bash
npm install @better-i18n/mcp
```

Connect AI assistants like [Claude](https://claude.ai), [Cursor](https://cursor.com), or [Windsurf](https://windsurf.com) to your translation workflow through the [Model Context Protocol](https://modelcontextprotocol.io/).

### Agent Skill

Give your AI agent permanent better-i18n knowledge — SDK setup, key naming, CDN behavior, GitHub sync, and MCP tool usage — without pasting prompts each session.

```bash
npx skills add better-i18n/skills
```

Works with Claude Code, Cursor, Windsurf, and any agent that supports custom instructions. See [github.com/better-i18n/skills](https://github.com/better-i18n/skills).

## Documentation

Visit [docs.better-i18n.com](https://docs.better-i18n.com) for full documentation:

- [Getting Started](https://docs.better-i18n.com/getting-started) — setup and first project
- [CLI Reference](https://docs.better-i18n.com/cli) — all commands and options
- [SDK Guides](https://docs.better-i18n.com/sdk) — Next.js, React, Expo integrations
- [API Reference](https://docs.better-i18n.com/api) — REST API documentation
- [MCP Integration](https://docs.better-i18n.com/mcp) — AI agent setup

## Related

- [better-i18n/skills](https://github.com/better-i18n/skills) — AI agent skills for i18n best practices
- [better-i18n/status.better-i18n.com](https://github.com/better-i18n/status.better-i18n.com) — open-source status page

## Contributing

Contributions are welcome! Please read our [contributing guidelines](./CONTRIBUTING.md) before submitting PRs.

## License

[MIT](./LICENSE) — Better i18n

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [better-i18n](https://github.com/better-i18n)
- **Source:** [better-i18n/oss](https://github.com/better-i18n/oss)
- **License:** MIT
- **Homepage:** https://better-i18n.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-better-i18n-oss
- Seller: https://agentstack.voostack.com/s/better-i18n
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
