# HebrewCore by [baba Hebrew](https://itsbaba.com)

**The language API for products that work in Hebrew.** Translate between Hebrew, English and Russian with verified protected values, render mixed Hebrew and English lines correctly, detect code-switched languages, transliterate, and add verified nikud for text-to-speech.

- Website: https://hc.itsbaba.com
- Docs: https://hc.itsbaba.com/docs · API reference: https://hc.itsbaba.com/reference
- OpenAPI: https://hc.itsbaba.com/openapi.json · llms.txt: https://hc.itsbaba.com/llms.txt
- MCP server: `https://hc.itsbaba.com/mcp`
- Status: https://hc-status.itsbaba.com · Pricing and access: https://hc.itsbaba.com/pricing
- Made by [baba Hebrew](https://itsbaba.com)

## What it does

| Capability | Endpoint |
|---|---|
| Protected translation (he, en, ru): prices, doses, codes, dates, names and your terms kept exactly; every sentence verified | `POST /v1/translate`, `POST /v1/translate/batch` |
| Domain modes: general, clinical, finance, legal; listener and speaker gender | `domain`, `listener_gender`, `speaker_gender` |
| ICU MessageFormat plurals (Hebrew dual, Russian plural forms) | `message_format: "icu"` |
| Render-ready RTL/LTR display and direction runs | `POST /v1/wrap`, `POST /v1/analyze` |
| Language detection for code-switched text | `POST /v1/detect` |
| Transliteration, nikud (vowel points) and nikud removal | `POST /v1/transliterate`, `POST /v1/nikud`, `POST /v1/strip-nikud` |
| Account term list kept exactly in every translation | `GET/POST /v1/terms`, `DELETE /v1/terms/{id}` |
| Clinical API with streaming (enabled per account) | `/v1/medical/*` |

## Quick start

Get a key in the console at https://hc.itsbaba.com/dashboard (access is by request at https://hc.itsbaba.com/pricing).

```bash
curl https://hc.itsbaba.com/v1/translate \
  -H "Authorization: Bearer $HEBREWCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Your order #A-10234 ships on 04/03/2026 for $129.99.","source_lang":"en","target_lang":"he","protect":true,"listener_gender":"female","quality":"fast"}'
```

More in [examples/](examples): curl, Node.js and Python.

## Use it from AI agents (MCP)

HebrewCore is a remote MCP server (Streamable HTTP) with 16 tools. Authenticate with your API key.

**Claude Code**
```bash
claude mcp add --transport http hebrewcore https://hc.itsbaba.com/mcp --header "Authorization: Bearer hc_live_..."
```

**Cursor** (`~/.cursor/mcp.json`) and **VS Code** (`.vscode/mcp.json`): see [mcp/](mcp).

Tools: `translate`, `translate_batch`, `analyze_direction`, `detect_language`, `wrap_for_display`, `transliterate`, `add_nikud`, `strip_nikud`, `list_languages`, `list_terms`, `add_terms`, `delete_term`, `clinical_translate`, `clinical_query`, `clinical_verify`, `health`.

## About

HebrewCore is built by [baba Hebrew](https://itsbaba.com), the Hebrew translation and learning app. Questions: admin@itsbaba.com.

The examples in this repository are MIT licensed. The HebrewCore API is a commercial service; see https://hc.itsbaba.com/pricing.