Koskamo

Word Aligner MCP

An MCP server that exposes a create_word_alignment tool to generate shareable word-alignment diagrams for bilingual text pairs via a free HTTP API, returning a link and preview image without authentication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Word Aligner MCP logo, by Dani PolaniCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Dani Polani
MCP endpoint (Streamable HTTP)
https://aligner.tinygods.dev/mcp
Vendor documentation

What its tools do

1 tool, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (1)

1 of 1 have a description · 1 of 1 declare behavior hints · 1 of 1 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Generate word alignment diagrams for bilingual sentence pairs
  • Create shareable links for parallel text visualization
  • Integrate word alignment into AI agent workflows

Source and maintenance

Community listingRegistry 1.0.0
mcp-registry: io.github.tinygodsdev/word-aligner@1.0.0Source repository
Maintenance checked

Protocol and capabilities

Server
word-aligner 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
1 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Word Aligner turns a phrase and its translation into a shareable visual diagram that connects matching words with colored arcs. Translate and tokenize the text yourself, work out which words correspond, then call create_word_alignment. Return the resulting URL to the user exactly as received, character for character without any modification; it opens the interactive diagram on aligner.tinygods.dev.

Tools

1 advertised

create_word_alignment — Create word alignment diagram
Advertised by the server during the last successful anonymous check.
Advertised read-only

Create a shareable Word Aligner diagram that shows which words match across two or more stacked lines of text (a translation and its source, an interlinear gloss, IPA, etc.). Returns a URL that opens the interactive diagram, plus a preview image. Use this when the user wants to translate a phrase and show word correspondences, align a translation with its source (including RTL scripts like Hebrew or Arabic, or vertically written ones like Japanese and Mongolian), or build a Leipzig-style interlinear gloss. Word indices are 0-based token positions. Tokenize each line the same way the tool does before assigning indices: - Whitespace always splits ("I have been going" -> I[0] have[1] been[2] going[3]). - The characters in settings.tokenSplitChars (default ".-|") also split and are then removed from the rendered text, so "go.PST.IPFV" becomes three tokens (go, PST, IPFV) and the dots disappear. For Leipzig glosses set tokenSplitChars to "-|" to keep the dots. - Punctuation stays attached by default ("Hello, world!" -> Hello,[0] world![1]). - In RTL lines, word 0 is the logically first word (rightmost on screen); index in reading order. - Japanese and Chinese are written without spaces and nothing is segmented for you: put spaces where the alignment units should be. For a vertically written script set settings.axis to "columns". Every line then becomes a vertical column and the connectors run sideways. Set orientation per line: "vertical" stacks the characters (Japanese, Chinese), "sideways" rotates the line a quarter turn (traditional Mongolian, and Latin runs inside vertical text), "upright" leaves a translation as horizontal word boxes. The first line is the leftmost column, so for Japanese and Chinese, whose columns read right to left, list the translation first and the script second. Each alignment is [lineA, wordA, lineB, wordB]; the two lines must be neighbours in the stack (|lineA - lineB| = 1), which means one above the other in rows and side by side in columns. To express many-to-one, list each target word as its own tuple. Tokens that share a connection group get the same color automatically.

create_word_alignment input schema
{
  "type": "object",
  "required": [
    "lines"
  ],
  "properties": {
    "lines": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "string",
            "description": "Plain line text (shorthand)."
          },
          {
            "type": "object",
            "required": [
              "text"
            ],
            "properties": {
              "rtl": {
                "type": "boolean",
                "description": "Right-to-left layout (Hebrew, Arabic, ...). Default false."
              },
              "font": {
                "type": "string",
                "description": "Google Fonts family name (e.g. \"Noto Sans Hebrew\"). Defaults to Inter."
              },
              "text": {
                "type": "string",
                "description": "Line text."
              },
              "gapPx": {
                "type": "integer",
                "maximum": 56,
                "minimum": 0,
                "description": "Horizontal gap between word tokens in px. Default 14."
              },
              "sizePx": {
                "type": "integer",
                "maximum": 64,
                "minimum": 12,
                "description": "Text size in px. Default 36."
              },
              "orientation": {
                "enum": [
                  "upright",
                  "vertical",
                  "sideways"
                ],
                "type": "string",
                "description": "How this line's glyphs are set, visible with settings.axis \"columns\". \"vertical\" stacks characters (Japanese, Chinese), \"sideways\" rotates the line (Mongolian). Default \"upright\"."
              }
            },
            "additionalProperties": false
          }
        ]
      },
      "maxItems": 8,
      "minItems": 1,
      "description": "Text lines, top to bottom. Each entry is a plain string or an object with per-line visual options."
    },
    "pairs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "upper",
          "lower"
        ],
        "properties": {
          "gapPx": {
            "type": "integer",
            "maximum": 156,
            "minimum": 12,
            "description": "Vertical gap between the two lines in px. Default 120."
          },
          "lower": {
            "type": "integer",
            "description": "0-based index of the lower line (must equal upper + 1)."
          },
          "upper": {
            "type": "integer",
            "description": "0-based index of the upper line."
          },
          "showConnectors": {
            "type": "boolean",
            "description": "Draw connectors between this pair. Default true."
          }
        },
        "additionalProperties": false
      },
      "description": "Per-pair controls for a specific adjacent line pair."
    },
    "settings": {
      "type": "object",
      "properties": {
        "axis": {
          "enum": [
            "rows",
            "columns"
          ],
          "type": "string",
          "description": "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."
        },
        "theme": {
          "enum": [
            "light",
            "dark"
          ],
          "type": "string",
          "description": "UI theme (token chip color). Default light."
        },
        "palette": {
          "enum": [
            "pastel",
            "vivid"
          ],
          "type": "string",
          "description": "Connection color palette. Default pastel."
        },
        "lineStyle": {
          "enum": [
            "straight",
            "curved"
          ],
          "type": "string",
          "description": "Connection line shape. Default curved."
        },
        "background": {
          "enum": [
            "light",
            "dark"
          ],
          "type": "string",
          "description": "Preview background. Default light."
        },
        "lineOpacity": {
          "type": "number",
          "maximum": 1,
          "minimum": 0.2,
          "description": "Connection line opacity. Default 1."
        },
        "showNumbers": {
          "type": "boolean",
          "description": "Show line numbers. Default false."
        },
        "lineThickness": {
          "type": "number",
          "maximum": 8,
          "minimum": 1,
          "description": "Connection line thickness. Default 3."
        },
        "tokenMergeChar": {
          "type": "string",
          "maxLength": 1,
          "description": "Single char that joins parts into one token rendered with a space (e.g. \"is+playing\"). Default \"+\"."
        },
        "tokenSplitChars": {
          "type": "string",
          "description": "Characters (besides whitespace) that split text into tokens and are then removed. Default \".-|\". Set \"-|\" to keep periods in Leipzig glosses."
        },
        "colorTokensByLink": {
          "type": "boolean",
          "description": "Tint word tokens in their connection color. Default true."
        }
      },
      "description": "Global visual overrides. Unset fields inherit defaults.",
      "additionalProperties": false
    },
    "alignments": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "maxItems": 4,
        "minItems": 4
      },
      "description": "Word-alignment links as [lineA, wordA, lineB, wordB] (0-based indices, lines must be adjacent)."
    }
  },
  "additionalProperties": false
}
create_word_alignment output schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The shareable diagram URL. Return this to the user exactly as received, character for character."
    }
  }
}
create_word_alignment annotations
{
  "title": "Create word alignment diagram",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
742 ms
95th percentile latency
742 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 742 ms · metadata changed · 1 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http word-aligner-mcp https://aligner.tinygods.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add word-aligner-mcp --url https://aligner.tinygods.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable word-aligner-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "word-aligner-mcp": {
      "url": "https://aligner.tinygods.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "word-aligner-mcp": {
      "type": "streamableHttp",
      "url": "https://aligner.tinygods.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start word-aligner-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "word-aligner-mcp": {
      "type": "http",
      "url": "https://aligner.tinygods.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http word-aligner-mcp https://aligner.tinygods.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://aligner.tinygods.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "word-aligner-mcp": {
      "serverUrl": "https://aligner.tinygods.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Word Aligner MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 7,928