Public
Remote MCP: flag every word rarer than the top-N English words
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data โ€“ all from the browser, and deployed in milliseconds.

Word Ceiling ๐Ÿ“

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

Connect

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 loop

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.

Tools

toolwhat it does
check_textFlags every word rarer than the ceiling. Returns pass/fail, coverage, needs_ceiling, and the offending words with ranks.
word_rankRanks specific words, so a replacement can be vetted before it's committed to.
list_ceilingsThe presets and what writing feels like at each one.

Ceilings

Nnamewhat it feels like
250nurseryUp Goer Five territory. Painful, funny, occasionally clarifying.
500very plainHard. Forces you to explain instead of name.
1,000plainThe XKCD "ten hundred words" bar. A good default for hard ideas.
2,000clearReads naturally. Kills most jargon without a fight.
5,000everydayNormal adult writing. Only real jargon trips it.
10,000educatedLoose. Catches showing off, not much else.
20,000wideOnly genuinely rare words are flagged.

The word list

50,000 words, blended from three public corpora by geometric mean of normalised frequency:

sourcewhat it measures
OpenSubtitles 2018how people talk
Wikipediahow people write
Google top 10ka 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.

Judgement calls

  • 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: false to 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.

Files

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

Remixing

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.

REST, if you don't have an MCP client

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.