word-aligner MCP server
Commit Nov 11, 2026Creates shareable word-alignment diagrams that visually connect words between different languages or translation tiers.
Also known as tinygodsdev/bitext-word-alignment, bitext-word-alignment
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 11, 2026
- License
- MIT
What is word-aligner MCP?
word-aligner creates shareable word-alignment diagrams that visually connect words between different languages or translation tiers.
Summary generated from the project's README
About word-aligner MCP server
Word Aligner is a web-based tool designed for language learners, teachers, linguists, and conlangers to create visual diagrams of word-to-word translations. It allows users to stack multiple rows of text, such as source sentences, translations, IPA, or glosses, and manually connect words using curved connectors. This manual approach ensures users maintain full control over one-to-many or many-to-one links, making it useful for showing complex word reordering or grammatical shifts.
Developers can integrate this functionality via a free HTTP API or an MCP server that provides a create_word_alignment tool. When used as an MCP server, it runs over Streamable HTTP without requiring authentication. The server returns a shareable URL and a preview image. Users can customize typography, tokenization, and directionality, including support for right-to-left scripts and vertical writing systems like Japanese tategaki. Final diagrams can be exported as PNG, SVG, PDF, or HTML files.
What you can do with it
- 1Visualize translation reorderingShow how words in a source sentence map to a target sentence even when the word order changes.
- 2Create linguistic glossesGenerate interlinear glosses that include morpheme alignment and IPA annotations for academic study.
- 3Document constructed languagesMap a constructed language onto English using custom script fonts and additional annotation tiers.
- 4Automate alignment linksProgrammatically generate shareable alignment URLs using a POST request to the API.
Written from the project's README. Every use case is checked against a quote from it.
How to install word-aligner MCP
Formats verified 10 Nov 2026Install word-aligner MCP in Claude Code
$ claude mcp add --transport http bitext-word-alignment https://aligner.tinygods.dev/mcpInstall word-aligner MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bitext-word-alignment": {
"url": "https://aligner.tinygods.dev/mcp"
}
}
}Install word-aligner MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bitext-word-alignment": {
"type": "http",
"url": "https://aligner.tinygods.dev/mcp"
}
}
}Install word-aligner MCP in Codex
~/.codex/config.toml
[mcp_servers.bitext-word-alignment] url = "https://aligner.tinygods.dev/mcp"
Install word-aligner MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"bitext-word-alignment": {
"httpUrl": "https://aligner.tinygods.dev/mcp"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work
- Source repository linked and reachabletinygodsdev/bitext-word-alignment is public and reachablegithub.com/tinygodsdev/bitext-word-alignment ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/tinygodsdev/bitext-word-alignment ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 438 msPass
README
View on GitHubAligner — 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.
word-aligner MCP questions
How do I add word-aligner MCP to Claude Code?
Run claude mcp add --transport http bitext-word-alignment https://aligner.tinygods.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add word-aligner MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can I use Word Aligner for?
It is used by language learners to see word matches, teachers to build handouts, linguists for interlinear glosses, and conlangers for mapping constructed languages.
Can I export the diagrams?
Yes, you can export your alignments as PNG, SVG, PDF, or a self-contained HTML file.
How do I share my work?
You can share your alignment via a link that encodes all text, links, and visual settings.