Write until nothing pokes through.
A public remote MCP server. A ceiling is the N most common English words; anything rarer pokes through it. Send text, get back every word that pokes through, with its rank.
Live: https://word-ceiling.val.run ยท Playground: https://word-ceiling.val.run/try ยท Docs: https://word-ceiling.val.run/help
No key, no account, no signup โ it's a pure function over text, so the URL is the setup.
https://word-ceiling.val.run/mcp?ceiling=1000
claude mcp add --transport http word-ceiling "https://word-ceiling.val.run/mcp?ceiling=1000"
?ceiling=N pins your house standard so it doesn't have to be repeated in every
request. Works in anything that takes a URL: claude.ai custom connectors, Claude Code,
Codex, MCP Inspector, the Pebble Index app.
The report isn't the product. The loop it drives is.
Rendering mermaid diagram...
check_text returns needs_ceiling โ the smallest ceiling this text would pass at.
That's the score. Drive it down.
| tool | what it does |
|---|---|
check_text | Flags every word rarer than the ceiling. Returns pass/fail, coverage, needs_ceiling, and the offending words with ranks. |
word_rank | Ranks specific words, so a replacement can be vetted before it's committed to. |
list_ceilings | The presets and what writing feels like at each one. |
| N | name | what it feels like |
|---|---|---|
| 250 | nursery | Up Goer Five territory. Painful, funny, occasionally clarifying. |
| 500 | very plain | Hard. Forces you to explain instead of name. |
| 1,000 | plain | The XKCD "ten hundred words" bar. A good default for hard ideas. |
| 2,000 | clear | Reads naturally. Kills most jargon without a fight. |
| 5,000 | everyday | Normal adult writing. Only real jargon trips it. |
| 10,000 | educated | Loose. Catches showing off, not much else. |
| 20,000 | wide | Only genuinely rare words are flagged. |
50,000 words, blended from three public corpora by geometric mean of normalised frequency:
| source | what it measures |
|---|---|
| OpenSubtitles 2018 | how people talk |
| Wikipedia | how people write |
| Google top 10k | a clean, hand-checked head |
Geometric mean is the whole trick: a word has to be common in all three registers to
rank high, so subtitle noise ("uh", "gonna") and encyclopedia jargon ("municipality",
"footballer") both sink. Against wordfreq โ a
much larger blend that can't be fetched at runtime โ this agrees on 86โ89% of the list
at every depth, and individual ranks track closely (ceiling 4,905 vs 5,210;
meditation 8,078 vs 7,595).
Read the list yourself: GET /api/words?from=1&to=200.
- Names and numbers are reported, not scored. You can't paraphrase your way out of "Anthropic". A capital mid-sentence is a name; a capital starting a sentence only counts as a name if the word isn't in the list at all, so "Anthropic ships models" is a name but "Elaborate on that" is still scored.
- Inflections inherit. "walked" passes when "walk" is common. Pass
inflections: falseto be strict. - Contractions expand before lookup, so "don't" is judged as "do" + "not". Forms that are real words with the apostrophe removed ("he'll" โ "hell", "we're" โ "were") only expand when the apostrophe was actually typed.
main.ts Hono: /mcp, REST mirror, splash, playground
mcp.ts JSON-RPC plumbing โ stateless streamable HTTP, SSE-framed for strict clients
tools.ts the three tools
ceiling.ts tokenise, expand, de-inflect, score
corpus.ts blob -> in-memory rank map, cached per cold start
build-corpus.ts fetch + blend + store the word list
rebuild.ts run this once after remixing
frontend/ splash + playground
Remix, then run rebuild.ts once to build the word list into your own blob storage
(~15s). Everything else works out of the box โ there's nothing to configure.
curl -X POST https://word-ceiling.val.run/api/check \ -H 'content-type: application/json' \ -d '{"text": "This constitutes a fundamental impediment.", "ceiling": 1000}' curl 'https://word-ceiling.val.run/api/rank?words=begin,commence,start&ceiling=1000' curl 'https://word-ceiling.val.run/api/words?from=1&to=50'
Built with the remote-mcp skill in dcm31/skillbook.
UI anchored on dcm31/call-my-human.