Skip to content

MCP serverEnglish Updated

MCP server for word lists by grade

The Dyslexia Steps MCP server lets Claude, ChatGPT, Codex, Cursor and other AI assistants look up 38 English word lists placed from Pre-K to Grade 3, with the source of each placement. It is free, read-only, needs no account, and the code is open source. Add https://mcp.dyslexiasteps.com/mcp to your client.

Connect your AI client

Hosted needs nothing installed and works everywhere, including ChatGPT and Claude's custom connectors. Local runs the same six tools on your own machine with npx -y dyslexiasteps-mcp and needs Node.js 18 or newer.

Connect Claude Code

Add the hosted URL with one command. A local install works too.

  1. Run the command in a terminal. --scope user makes the server available in all your projects; without it the server only applies to the current project.
  2. claude mcp list should show the server as Connected. Inside Claude Code, /mcp shows the same status.
  3. To share the server with a team, use --scope project: the command writes a .mcp.json file in the project root that you can commit.

Hosted (recommended)

claude mcp add --transport http --scope user dyslexiasteps https://mcp.dyslexiasteps.com/mcp

Local (npx)

claude mcp add --scope user dyslexiasteps -- npx -y dyslexiasteps-mcp

.mcp.json (project)

{
  "mcpServers": {
    "dyslexiasteps": {
      "type": "http",
      "url": "https://mcp.dyslexiasteps.com/mcp"
    }
  }
}

Check / remove

claude mcp list
claude mcp get dyslexiasteps
claude mcp remove dyslexiasteps

Check it works. Ask: “Using Dyslexia Steps, how many English word lists cover kindergarten?” The answer should be 23.

The -- separates Claude's own options from the command that starts the server. Keep it in the npx line.

Source: Claude Code: MCP

The six tools

All are read-only. Each answer carries its source, so an assistant can cite it.

ToolWhat it returnsTry asking
list_word_listsThe available lists with id, title, language, section, grade range, the source of the grade placement and word count. Filter by language, grade or section.Which word lists cover first grade, and where does each grade placement come from?
get_word_listOne list in full: every word, its groups (for example -at, -an, -ap families), the grade range, the placement basis, the page URL and the license.Show me the short a word list grouped by word family.
get_words_for_gradeEvery different English word from the lists that cover a grade, deduplicated, with the lists each word comes from; optional section filter.Give me 30 digraph words suitable for a first grader.
find_wordsWords that start with, end with or contain a pattern such as sh, ck or ight, with their list, grade range and page.Find words ending in ck from the kindergarten and first grade lists.
get_placement_basisHow grades were assigned: Dolch's own grade levels (1936, public domain), the Common Core Foundational Skills item that names the skill, or a typical sequence when no standard names it. Includes the limits.Why is the r-controlled vowels list placed in Grade 1?
get_citationThe license (CC BY 4.0 for the compilation; the Dolch words are public domain), the citation text and the CSV and JSON download addresses.How do I cite these word lists and may I print them for my class?

Parameters and real example responses are in the tool reference.

What to ask

  • “Give me 20 words with sh for a first grader.”
  • “Which sight words belong to kindergarten, and how were they placed there?”
  • “I teach second grade: what vowel team words can I use, with their source?”
  • “Show me every list that has words ending in ight.”
  • “Which word lists exist in Spanish?”

What it does not do

  • It does not assess a child. It returns word lists. A grade is a typical guide, not a rule, and a placement is not an assessment of any child.
  • It gives no advice about a learning difficulty. The screening test on dyslexiasteps.com is a screening, not a diagnosis; only a specialist can diagnose dyslexia.
  • It writes nothing, opens no account and spends no credits. All six tools are read-only and need no API key or sign-in.
  • Other languages have no grades. The German, Spanish, French, Dutch and Brazilian Portuguese lists follow each language's own reading curriculum, so they are not mapped to US grades.

The lists themselves, with the source of every grade placement, are on word lists by grade.

Troubleshooting

The tools do not appear in my client.

Quit the client completely and reopen it; many clients read their MCP configuration only at start-up. Then check the JSON or TOML syntax: a trailing comma or a missing quote silently drops the server. In Claude Code claude mcp list shows whether it is connected, in Cursor the MCP settings page does, and in VS Code the status line above the server in .vscode/mcp.json does.

`npx` is not found or will not start.

A local install needs Node.js 18 or newer (node --version). On Windows, if npx is missing, install npm globally with npm install -g npm. With the hosted URL you do not need Node.js at all.

Opening the MCP address in a browser shows 405.

That is expected. The server accepts only the POST /mcp request MCP clients send. To see that it is running, open https://mcp.dyslexiasteps.com/health (it answers ok) or run the curl command on this page.

ChatGPT or Claude does not show the custom connector option.

Custom connectors depend on your plan and your organization's settings. In ChatGPT, Developer mode must be on, and on Business, Enterprise, Team and Edu accounts an admin has to allow connectors. Clients rename menus: search their help pages for custom connector to find the current path.

A tool returns an error.

The input was invalid, for example get_word_list was given an id that does not exist. The error message points to list_word_lists, which shows the valid ids. find_words needs at least one of contains, starts_with or ends_with.

MCP server: frequently asked questions

What is the Dyslexia Steps MCP server?

A free, read-only Model Context Protocol server that lets an AI assistant look up Dyslexia Steps' word lists: 38 English phonics and sight word lists placed from Pre-K to Grade 3 with the source of each placement, plus 216 lists in German, Spanish, French, Dutch and Brazilian Portuguese. The code is MIT-licensed; the word lists are CC BY 4.0.

Does it assess my child or tell me whether they have dyslexia?

No. It only returns word lists. A grade is a typical guide, not a rule, and a placement is not an assessment of any child. The free screening test on dyslexiasteps.com is a screening, not a diagnosis; only a specialist can diagnose dyslexia.

Do I need an account or an API key?

No. The hosted server needs no sign-up, key or credit balance, and all six tools are read-only.

How were the grades assigned?

Each English list carries the source of its placement: Dolch's own grade levels for the sight word lists (1936, public domain), the Common Core Foundational Skills item that names the skill for phonics lists (for example RF.1.3.a for consonant digraphs), or a typical sequence when no standard names it. Programs differ, so treat grades as a guide.

Hosted or local: which should I use?

Use the hosted URL unless you need to work offline or want to inspect the code you run. Both expose the same six tools. The hosted server needs no Node.js and works in ChatGPT and in Claude's custom connectors, which cannot launch a local npx process.

Which AI clients does it work with?

Any client that speaks MCP: Claude (claude.ai, Desktop and Claude Code), ChatGPT through Developer mode connectors, Codex, Cursor, VS Code, Gemini CLI and others. The setup commands for each are in these docs, taken from the clients' own documentation.

May I print and share the word lists?

Yes. The compilation is licensed CC BY 4.0: credit Dyslexia Steps and link the word lists by grade page. The Dolch words themselves are public domain. Each list page prints as a worksheet with its source line.

Is the code open source?

Yes. The data package and the MCP server are MIT-licensed code in public repositories at github.com/Dyslexia-Steps.

Packages and source code

The data package and the MCP server are MIT-licensed code in public repositories at github.com/Dyslexia-Steps, published on npm. The word lists are CC BY 4.0. The developer docs have one page per client and the dataset schema; everything is also on the developers page.

dyslexiasteps-mcp

MCP server for AI assistants: phonics and sight word lists placed by grade with sources. Six read-only tools.

npx -y dyslexiasteps-mcp

npmGitHubDocs

dyslexiasteps-data

The word lists as JSON and CSV with small helpers: lists and words for a grade. Word lists CC BY 4.0.

npm install dyslexiasteps-data

npmGitHubDocs

dyslexiasteps-embed

The free reading games as a web component and React wrapper: add a game to a school, tutoring or parenting site in six languages.

npm install dyslexiasteps-embed

npmGitHubDocs