About word-aligner
Word Aligner is a web tool for manually linking words across a sentence and its translation, with extra rows for glosses or IPA. It serves language learners, teachers, and linguists, and exports diagrams or shareable links; an HTTP API is also available.
Key features
- 01Align words across multiple lines
- 02Create one-to-many and crossing links
- 03Add gloss and IPA rows
- 04Support RTL and vertical layouts
- 05Customize tokenization and typography
- 06Export diagrams or share links
Use cases
- 01Show word correspondences in language lessons
- 02Prepare glossed examples for linguistic work
- 03Document constructed-language translations
- 04Generate and share an alignment through the API
MCP support
An MCP server at `https://aligner.tinygods.dev/mcp` exposes the `create_word_alignment` tool. It returns a shareable link and preview image over Streamable HTTP without authentication.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://aligner.tinygods.dev/mcpclaude mcp add --transport http tinygodsdev-word-aligner https://aligner.tinygods.dev/mcp{"mcpServers":{"tinygodsdev-word-aligner":{"type":"http","url":"https://aligner.tinygods.dev/mcp"}}}Open in Cursor{"servers":{"tinygodsdev-word-aligner":{"type":"http","url":"https://aligner.tinygods.dev/mcp"}}}Open in VS Code{"mcpServers":{"tinygodsdev-word-aligner":{"type":"http","url":"https://aligner.tinygods.dev/mcp"}}}{"mcpServers":{"tinygodsdev-word-aligner":{"serverUrl":"https://aligner.tinygods.dev/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
1| Parameter | Type | Required | Description |
|---|---|---|---|
| lines | array | Yes | Text lines, top to bottom. Each entry is a plain string or an object with per-line visual options. |
| pairs | array | No | Per-pair controls for a specific adjacent line pair. |
| settings | object | No | Global visual overrides. Unset fields inherit defaults. |
| settings.axis | enum | No | Flow direction of the diagram. "rows" (default) stacks lines downward with vertical connectors. "columns" stands each line up as a vertical column with sideways connectors, for Japanese, Chinese, and Mongolian; the first line is the leftmost column.rows | columns |
| settings.theme | enum | No | UI theme (token chip color). Default light.light | dark |
| settings.palette | enum | No | Connection color palette. Default pastel.pastel | vivid |
| settings.lineStyle | enum | No | Connection line shape. Default curved.straight | curved |
| settings.background | enum | No | Preview background. Default light.light | dark |
| settings.lineOpacity | number | No | Connection line opacity. Default 1. |
| settings.showNumbers | boolean | No | Show line numbers. Default false. |
| settings.lineThickness | number | No | Connection line thickness. Default 3. |
| settings.tokenMergeChar | string | No | Single char that joins parts into one token rendered with a space (e.g. "is+playing"). Default "+". |
| settings.tokenSplitChars | string | No | Characters (besides whitespace) that split text into tokens and are then removed. Default ".-|". Set "-|" to keep periods in Leipzig glosses. |
| settings.colorTokensByLink | boolean | No | Tint word tokens in their connection color. Default true. |
| alignments | array | No | Word-alignment links as [lineA, wordA, lineB, wordB] (0-based indices, lines must be adjacent). |
Details
From the project READMEAligner — word-by-word translation visualizer
Word Aligner is a free web tool that shows which word matches which across stacked lines of text. Type or paste a sentence and its translation, click a word and then its match on the line above or below, and curved connectors draw the alignment between them. Add extra rows for glosses or IPA, then export the diagram or share it with a link.
No accounts, no machine translation — you stay in control of every link. Great for lessons, social posts, grammar notes, and conlang documentation.

What it's for
- Language learners — see exactly why a translation says what it does: which source word became which target word, what gets dropped, and where word order changes.
- Teachers — build handouts, slides, and flashcards; export a clean PNG or SVG and drop it into a lesson without retyping anything.
- Linguists — produce Leipzig-style interlinear glosses with morpheme alignment, case/agreement tags, and free translations.
- Conlangers — show how a constructed language maps onto English, with custom script fonts, gloss rows, and IPA.
What it does
- Multi-line alignment — stack as many rows as you need (source, translation, gloss, IPA); links connect vertically adjacent lines.
- Manual word linking — click a word, then its match; supports one-to-many and many-to-one links and freely crossing connectors for reordered translations.
- Interlinear glosses & IPA — add annotation tiers above or below any line.
- Right-to-left scripts — Hebrew, Arabic, and mixed LTR/RTL layouts.
- Vertical writing systems — stand the whole diagram up as columns for Japanese tategaki, Chinese, or traditional Mongolian; characters stack or the line rotates, chosen per line, so a horizontal translation stays readable beside it.
- Tokenization control — choose how text splits into word boxes (split characters, a join marker for fixed expressions, optional punctuation handling).
- Per-line typography — font, size, spacing, and direction per line; custom and Google Fonts.
- Exports — PNG, SVG, PDF, and a self-contained HTML file; exports match the preview, including custom-font shaping.
- Shareable URLs — the whole alignment (text, links, and visual settings) is encoded in a
?data=link.
Examples
Browse ready-made examples — bilingual pairs, Turkish interlinear with IPA, RTL scripts, vertical Japanese and traditional Mongolian, Tagalog compounds, Japanese–Chinese–English word order, and more interlinear glosses — at aligner.tinygods.dev/examples. Open any one in the editor to adapt it.


How it works
Edit your lines in the line editor, then link words in the preview.

Tune colors, tokenization, and fonts in settings, then export or share.

Word alignment vs. interlinear vs. parallel text
- Interlinear translation places a gloss directly under each source word — compact, but it hides reordering. Aligner keeps both sentences on their own line and draws connectors, so reorderings, splits, and merges stay obvious.
- Parallel text is side-by-side bilingual reading for long-form study. Aligner focuses on one sentence pair at a time with explicit connectors showing which tokens correspond.
API
Word Aligner has a free HTTP API for generating alignment links programmatically.
POST https://aligner.tinygods.dev/api/align
Content-Type: application/json
{
"lines": ["Hello world", "Bonjour le monde"],
"alignments": [[0, 0, 1, 0], [0, 1, 1, 2]]
}
Returns { "url": "https://aligner.tinygods.dev/?data=..." }.
Supports per-line options (font, size, RTL), global visual settings (palette, line style, background), pair-level gap control, and multi-line stacks with selective connectors.
- API docs: aligner.tinygods.dev/api
- OpenAPI schema: aligner.tinygods.dev/api/align/openapi.json
Using Word Aligner as an AI agent tool
The word-aligner-skill/ directory is a ready-to-install skill that teaches AI assistants (Claude, ChatGPT, etc.) how to use the API. Once installed, it enables flows like:
"Translate 'я хочу спать' into English and show me the word alignment."
The agent translates, calls the API, and returns a shareable link.
- For Claude: point your Claude project at this repository or add the contents of
word-aligner-skill/SKILL.mdas a custom instruction. - For ChatGPT: zip
word-aligner-skill/and upload it as a custom Skill.
Install instructions and a downloadable archive are also on the site: aligner.tinygods.dev/skill.
MCP server
There is also an MCP server at https://aligner.tinygods.dev/mcp that exposes a single create_word_alignment tool. It returns a shareable link plus a preview image, and runs inside the same app over Streamable HTTP with no auth. Connect it in Claude:
claude mcp add --transport http word-aligner https://aligner.tinygods.dev/mcp
See docs/mcp-server.md for ChatGPT Developer Mode setup and the tool schema.
Learn more
- App: aligner.tinygods.dev
- About / documentation: aligner.tinygods.dev/about
- Privacy: aligner.tinygods.dev/privacy
Created by Dani Polani. See other tools for linguistics and conlanging.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.