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.
- Run the command in a terminal.
--scope usermakes the server available in all your projects; without it the server only applies to the current project. claude mcp listshould show the server as Connected. Inside Claude Code,/mcpshows the same status.- To share the server with a team, use
--scope project: the command writes a.mcp.jsonfile in the project root that you can commit.
Hosted (recommended)
claude mcp add --transport http --scope user dyscalculia https://mcp.dyscalculia.io/mcpLocal (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 dyscalculiaCheck 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
Connect Claude (claude.ai and Desktop)
A remote server is added as a custom connector. It needs the hosted URL; npx does not work here.
- Pro and Max: open the + menu in the chat box, choose Add custom connector, paste the URL below and press Add. No sign-in is needed, so leave the OAuth fields under Advanced settings empty.
- Team and Enterprise: an Owner first adds the connector in the organization's Connectors settings: Add → Custom → Web. Members then find it in their list and press Connect.
- Open a new chat, switch the connector on and try the check prompt further down this page.
Connector URL
https://mcp.dyscalculia.io/mcpCheck 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.
Menu names in Claude change from time to time. If you do not see the option, search Claude's help for custom connectors. Anthropic warns on its own page that custom connectors can reach unverified services.
Connect Claude Desktop (local)
To run the server on your own machine with npx, add it to Claude Desktop's config file.
- From the Claude menu open Settings → Developer → Edit Config. The file is
~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS and%APPDATA%\Claude\claude_desktop_config.jsonon Windows. - Add the block below inside
mcpServers. If the file already has other servers, add only thedyscalculiaentry. - Quit Claude Desktop completely and reopen it. The server appears under the + menu in the chat box, Connectors → Manage connectors.
claude_desktop_config.json
{
"mcpServers": {
"dyscalculia": {
"command": "npx",
"args": ["-y", "dyscalculia-mcp"]
}
}
}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.
If it does not connect, read the logs: ~/Library/Logs/Claude/mcp*.log on macOS, %APPDATA%\Claude\logs on Windows. Node.js must be installed (node --version).
Source: MCP: connect to local servers
Connect ChatGPT
Only a remote (hosted) server works. ChatGPT cannot start a local npx process.
- In ChatGPT Settings, turn on Developer mode. The switch is usually under Apps / Connectors → Advanced, and under Security on some accounts.
- On the connectors page press Create. Use
Dyscalculia.ioas the name, one sentence as the description (for example Dyscalculia prevalence figures and study sources) and the URL below. - Choose No authentication, tick the trust box and create the connector.
- In a new chat, enable the connector from the tools menu.
Connector URL
https://mcp.dyscalculia.io/mcpCheck 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.
Which plans include Developer mode, and its menu names, change on OpenAI's side. On Business and Enterprise an admin may have to allow custom connectors. None of the tools writes anything; all six are read-only.
Connect Codex
The Codex CLI and the IDE extension read the same config.toml. Use --url for hosted, npx for local.
- Run one of the commands. Codex writes the configuration to
~/.codex/config.toml. - To edit by hand, add a
[mcp_servers.dyscalculia]table to that file. For a per-project setup, put the table in.codex/config.tomlat the root of a trusted project. - Restart Codex and try the check prompt below.
Hosted (recommended)
codex mcp add dyscalculia --url https://mcp.dyscalculia.io/mcpLocal (npx)
codex mcp add dyscalculia -- npx -y dyscalculia-mcpconfig.toml (hosted)
[mcp_servers.dyscalculia]
url = "https://mcp.dyscalculia.io/mcp"config.toml (local)
[mcp_servers.dyscalculia]
command = "npx"
args = ["-y", "dyscalculia-mcp"]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.
Source: Codex: MCP
Connect Cursor
Add a URL or a command to mcp.json, for one project or for every project.
- Create (or open)
~/.cursor/mcp.jsonfor all projects, or.cursor/mcp.jsonin a project root for that project only. - Add one of the blocks below inside
mcpServersand save. - In Cursor's settings, open the MCP section and check that the server is on and its tools are listed.
Hosted (recommended)
{
"mcpServers": {
"dyscalculia": {
"url": "https://mcp.dyscalculia.io/mcp"
}
}
}Local (npx)
{
"mcpServers": {
"dyscalculia": {
"command": "npx",
"args": ["-y", "dyscalculia-mcp"]
}
}
}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.
Source: Cursor: MCP
Connect VS Code
The workspace file is .vscode/mcp.json. Its top-level key is servers, not mcpServers.
- Create
.vscode/mcp.jsonin the project root and paste one of the blocks below. The MCP: Add Server command in the Command Palette walks through the same setup. - Start the server with the Start link that appears above it in the file. The tools show up in Copilot Chat's Agent mode.
- To add the local server to your user profile instead of one workspace, use the command-line form.
Hosted (recommended)
{
"servers": {
"dyscalculia": {
"type": "http",
"url": "https://mcp.dyscalculia.io/mcp"
}
}
}Local (npx)
{
"servers": {
"dyscalculia": {
"type": "stdio",
"command": "npx",
"args": ["-y", "dyscalculia-mcp"]
}
}
}User profile (local)
code --add-mcp "{\"name\":\"dyscalculia\",\"command\":\"npx\",\"args\":[\"-y\",\"dyscalculia-mcp\"]}"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.
Source: VS Code: MCP servers
Connect Gemini CLI
Use gemini mcp add or edit settings.json. The key for a remote server is httpUrl.
- Run the command. The default scope is project; add
-s userto use the server everywhere (it is written to~/.gemini/settings.json). - If you edit the file by hand, use `httpUrl`, not
url, for a remote Streamable HTTP server:urlis for the older SSE address.
Hosted (recommended)
gemini mcp add -s user --transport http dyscalculia https://mcp.dyscalculia.io/mcpsettings.json (hosted)
{
"mcpServers": {
"dyscalculia": {
"httpUrl": "https://mcp.dyscalculia.io/mcp"
}
}
}settings.json (local)
{
"mcpServers": {
"dyscalculia": {
"command": "npx",
"args": ["-y", "dyscalculia-mcp"]
}
}
}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.
Source: Gemini CLI: MCP servers
Connect Any other client
Any MCP client that supports Streamable HTTP works with the hosted URL. Clients that only support stdio use npx.
- Enter the URL below in the client's remote MCP server field. There is no authentication and no header to set.
- For a client that only supports local (stdio) servers, set the command to
npxand the arguments to-y dyscalculia-mcp. - To check the connection without any client, the
curlcommand below returns the tool list.
URL
https://mcp.dyscalculia.io/mcpCheck with curl
curl -s https://mcp.dyscalculia.io/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'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 server is stateless and accepts only POST /mcp, so opening the address in a browser returns 405. That is normal. https://mcp.dyscalculia.io/health answers ok.
Source: Model Context Protocol
The six tools
All are read-only. Each answer carries its source, so an assistant can cite it.
| Tool | What it returns | Try asking |
|---|---|---|
| get_prevalence | Prevalence 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_studies | The 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_reference | One source in full: the citation text and the link to the publication. | Give me the full reference for the Israeli population study. |
| explain_screening_test | How 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_citation | How 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_data | The 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-mcpMCP server for AI assistants: dyscalculia prevalence figures with sources, and how the free screening test works. Six read-only tools.
npx -y dyscalculia-mcpdyscalculia-dataThe statistics as JSON and CSV with small helpers: figures, studies and sources. Compilation CC BY 4.0.
npm install dyscalculia-data