Skip to content

MCP serverEnglish Updated

MCP server for dyscalculia statistics

The Dyscalculia.io MCP server lets Claude, ChatGPT, Codex, Cursor and other AI assistants look up sourced dyscalculia prevalence figures, the studies behind them and how the free screening test works. It is free, read-only, needs no account, and the code is open source. Population studies put dyscalculia at about 3 to 6 in 100 school-age children; the server returns that range and every study separately, each with its year. Add https://mcp.dyscalculia.io/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 dyscalculia-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 dyscalculia https://mcp.dyscalculia.io/mcp

Local (npx)

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

.mcp.json (project)

{
  "mcpServers": {
    "dyscalculia": {
      "type": "http",
      "url": "https://mcp.dyscalculia.io/mcp"
    }
  }
}

Check / remove

claude mcp list
claude mcp get dyscalculia
claude mcp remove dyscalculia

Check it works. Ask: “Using Dyscalculia.io, what share of school-age children have dyscalculia, and what is the source?” The answer should be about 3 to 6 percent, with the study it comes from and its year.

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
get_prevalencePrevalence figures from the statistics page, each with its data year and source: the overall range, single population studies, country counts.How common is dyscalculia, and which studies say so?
list_studiesThe studies behind the figures, with sample size, year and a link to the original publication.Which studies report dyscalculia prevalence, and how many children did each include?
get_referenceOne source in full: the citation text and the link to the publication.Give me the full reference for the Israeli population study.
explain_screening_testHow the free screening test works: its games, items and scoring, and what it does not measure. A description of the test, never a result.How is the free dyscalculia screening test scored, and what does it not cover?
get_citationHow to cite the compilation, its license (CC BY 4.0) and the CSV and JSON download addresses.How do I cite these dyscalculia statistics in a report?
list_chart_dataThe data behind each chart on the statistics page, row by row, with sources.Give me the numbers behind the prevalence chart as a table.

Parameters and real example responses are in the tool reference.

What to ask

  • “How common is dyscalculia in school-age children, and where does that number come from?”
  • “Which studies on dyscalculia and dyslexia overlap are listed, and how big were they?”
  • “I am writing a school report: give me the prevalence figures with a citation for each.”
  • “How does the free screening test work, and what does it not tell me?”
  • “Give me the data behind the dyscalculia charts as a table.”

What it does not do

  • It does not screen or assess anyone. It returns published figures and a description of how the free screening test works. It takes no answers, returns no scores and gives no result. The test itself runs on dyscalculia.io and is a screening, not a diagnosis; only a qualified professional can diagnose dyscalculia.
  • It does not invent a single world rate. No published meta-analysis gives one pooled figure, so the server returns the range from population studies and each study separately, each with its year.
  • It gives no advice about a child. The figures describe groups of children, not one child.
  • It writes nothing, opens no account and spends no credits. All six tools are read-only and need no API key or sign-in.

The figures themselves, with the source of every number, are on the dyscalculia statistics page; how the free test is built is on the methodology page.

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.

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.dyscalculia.io/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 a reference key that does not exist. The error message lists the valid choices; list_studies shows the available studies.

MCP server: frequently asked questions

What is the Dyscalculia.io MCP server?

A free, read-only Model Context Protocol server that lets an AI assistant look up the figures on Dyscalculia.io's statistics page: prevalence from population studies, the studies themselves with their sources, how the free screening test is built, and how to cite it. The code is MIT-licensed; the compilation is CC BY 4.0.

Does it test my child or tell me whether they have dyscalculia?

No. It returns published figures and a description of the test, never a result. The free screening test on dyscalculia.io is a screening, not a diagnosis; only a qualified professional can diagnose dyscalculia.

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.

Where do the numbers come from?

From the published studies listed on the statistics page. Each figure carries its data year and a source key, and the server returns both, so an assistant can cite them. Figures we calculated ourselves from a source are marked as ours.

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 on this page, taken from the clients' own documentation.

May I reuse the figures?

The compilation (tables, charts and text) is licensed CC BY 4.0: credit Dyscalculia.io and link the statistics page. Each underlying figure belongs to the source it cites.

Is the code open source?

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

Packages and source code

The data package, the MCP server and the embed package are MIT-licensed code in public repositories at github.com/Dyscalculia-io. The compilation is CC BY 4.0. The developer docs have one page per client and the dataset schema; everything is also on the developers page.

dyscalculia-mcp

MCP server for AI assistants: dyscalculia prevalence figures with sources, and how the free screening test works. Six read-only tools.

npx -y dyscalculia-mcp

npmGitHubDocs

dyscalculia-data

The statistics as JSON and CSV with small helpers: figures, studies and sources. Compilation CC BY 4.0.

npm install dyscalculia-data

npmGitHubDocs

dyscalculia-embed

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

npm install dyscalculia-embed

npmGitHubDocs