nctb-mcp

An MCP server that lets any AI assistant look up the Bangladesh NCTB curriculum by chapter, section and learning objective, with the official PDF page for everything it returns. Works offline (npx), read-only, no API keys.

v0.1 scope: Class 9-10 (SSC) Physics, 2026 edition, Bangla version and English version. All data is machine-extracted and marked verified: false until a human checks it. See Data status.

You:    Give me Class 9 physics chapter 3.
Claude: (calls get_topic {chapter: 3})
        Chapter 3, বল (Force), PDF pages 67-102 (printed 62-97): 9 sections, 3.1 জড়তা এবং বলের ধারণা:
        নিউটনের প্রথম গতি সূত্র … 3.9 ঘর্ষণ বল, plus 12 subsections. 12 learning objectives,
        6 worked examples, 7 MCQ + 2 creative + 4 short exercise items. Read it in the official NCTB PDF from page 67.

Use it from Claude Desktop, Cursor or any MCP client

{
  "mcpServers": {
    "nctb": { "command": "npx", "args": ["-y", "nctb-mcp"] }
  }
}

• Claude Desktop: Settings › Developer › Edit Config (claude_desktop_config.json), paste the block, restart.

• Cursor: ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), same block.

• From a local checkout (before the npm release): "command": "node", "args": ["/path/to/nctb-mcp/dist/cli.js"].

Related MCP server: BNCC MCP Server

Tools

Every response is small JSON with IDs for drill-down, the source PDF page (and printed page), and the verified flag.

Subjects accept English, Bangla or romanised Bangla (physics, পদার্থবিজ্ঞান, podartho biggan). Classes accept 9, 10, 9-10, SSC, নবম, দশম. Section numbers accept Bangla digits ("৩.২"). version is bn (default) or en; the two versions are separate books with different page numbers.

Example responses

Real output of the built server (v0.1.0, captured with the MCP Inspector CLI on 2026-11-07).

get_topic {"chapter": 1, "topic": "1.5"}

{
  "type": "topic",
  "id": "nctb:phy:c9-10:bn:ch01:t05",
  "number": "1.5",
  "title": "ভৌত রাশি এবং তাদের পরিমাপ",
  "printed_page": 14,
  "pdf_page": 19,
  "verified": false,
  "level": "topic",
  "chapter": {
    "id": "nctb:phy:c9-10:bn:ch01",
    "number": 1,
    "title": "ভৌত রাশি এবং তাদের পরিমাপ"
  },
  "parent_id": null,
  "subtopics": [
    {
      "id": "nctb:phy:c9-10:bn:ch01:t05:s01",
      "number": "1.5.1",
      "title": "পরিমাপের একক",
      "title_alt": "Units of Measurements",
      "printed_page": 15,
      "pdf_page": 20,
      "verified": false
    },
    {
      "id": "nctb:phy:c9-10:bn:ch01:t05:s02",
      "number": "1.5.2",
      "title": "উপসর্গ বা গুণিতক",
      "title_alt": "Prefix",
      "printed_page": 17,
      "pdf_page": 22,
      "verified": false
    },
    {
      "id": "nctb:phy:c9-10:bn:ch01:t05:s03",
      "number": "1.5.3",
      "title": "মাত্রা",
      "title_alt": "Dimension",
      "printed_page": 18,
      "pdf_page": 23,
      "verified": false
    },
    {
      "id": "nctb:phy:c9-10:bn:ch01:t05:s04",
      "number": "1.5.4",
      "title": "বৈজ্ঞানিক প্রতীক ও সংকেত",
      "title_alt": "Scientific Symbols and Notations",
      "printed_page": 19,
      "pdf_page": 24,
      "verified": false
    }
  ],
  "previous_id": "nctb:phy:c9-10:bn:ch01:t04:s03",
  "next_id": "nctb:phy:c9-10:bn:ch01:t05:s01",
  "worked_example_ids": [],
  "source": {
    "book_id": "nctb:phy:c9-10:bn",
    "printed_page": 14,
    "pdf_page": 19,
    "pdf_urls": [
      "https://drive.google.com/file/d/13P5E08HcNbpALj8-aC-RUCy0d3iwodet/view",
      "https://drive.egovcloud.gov.bd/index.php/s/KOdI1T0gyhPiFRz"
    ],
    "official_listing_url": "https://nctb.gov.bd/pages/static-pages/695b99afc4774958d7b70612",
    "edition": 2026
  },
  "notice": "Structure, IDs, objectives and page pointers only. Textbook content belongs to NCTB (all rights reserved); open the official PDF page for the text. Items are machine-extracted (OCR) and verified=false until a human checks them."
}

search_curriculum {"query": "momentum", "version": "en", "limit": 3}

{
  "query": "momentum",
  "hits": [
    {
      "id": "nctb:phy:c9-10:en:ch03:t04",
      "type": "topic",
      "number": "3.4",
      "title": "Momentum",
      "chapter_id": "nctb:phy:c9-10:en:ch03",
      "version": "en",
      "printed_page": 70,
      "pdf_page": 75,
      "verified": false
    },
    {
      "id": "nctb:phy:c9-10:en:ch03:t05:s01",
      "type": "topic",
      "number": "3.5.1",
      "title": "Conservation of Momentum and Energy",
      "chapter_id": "nctb:phy:c9-10:en:ch03",
      "version": "en",
      "printed_page": 71,
      "pdf_page": 76,
      "verified": false
    },
    {
      "id": "nctb:phy:c9-10:en:ch03:o08",
      "type": "objective",
      "title": "explain the conservation laws of momentum and collision.",
      "chapter_id": "nctb:phy:c9-10:en:ch03",
      "version": "en",
      "printed_page": 62,
      "pdf_page": 67,
      "verified": false
    }
  ]
}

An unknown ID returns isError: true with {"error": "Unknown ID nctb:phy:c9-10:bn:ch99", "hint": "Use list_chapters or search_curriculum to get valid IDs."}.

IDs

nctb:<subject>:<class>:<version>:ch<NN>[:t<NN>[:s<NN>] | :o<NN> | :we<NN> | :ex:<kind><NN>], e.g. nctb:phy:c9-10:bn:ch03:t02 = Physics, Classes 9-10, Bangla version, chapter 3, section 3.2. Topic numbers are the book's own section numbers. Full scheme: IDS.md. The same IDs are used by the BanglaEdu Bench.

What is in the data, and what is not

The NCTB textbooks are © NCTB, "[All rights reserved by the Publisher]". The PDFs are free from NCTB; this package points to them instead of copying them. See DATA_LICENSE.md.

Data provenance

Both were downloaded on 2026-11-07 from the links on NCTB's page "২০২৬ শিক্ষাবর্ষের মাধ্যমিক স্তরের নবম-দশম শ্রেণির পাঠ্যপুস্তক" (https://nctb.gov.bd/pages/static-pages/695b99afc4774958d7b70612). The Google Drive and egovcloud mirrors NCTB links serve files of identical size.

Pipeline (pipeline/, Python + Tesseract 5):

1. OCR every page (ocr.sh <pdf> <out-dir> <langs> [dpi]; resumable, JOBS/TESSDATA_PREFIX from the environment): the PDFs are scanned images, so there is no text to extract directly. Bangla book: ben+eng tessdata_best at 200 dpi. English book: eng at 150 dpi. Run everything with OCR_DIR=<ocr> [PDF_DIR=<pdfs>] pipeline/run.sh.

2. Fix Bangla Unicode and conjuncts (fix_bangla.py): NFC, one form for য়/ড়/ঢ়, stray zero-width characters, | → ।, and a reviewed word list for OCR conjunct errors (ভোত→ভৌত, যন্দ্র→যন্ত্র, ত্রটি→ত্রুটি, ধুবক→ধ্রুবক …). Legacy Bijoy/SutonnyMJ text is detected and reported, never returned.

3. Structure (structure.py): chapter list hand-transcribed from the printed contents page; sections from numbered headings; objectives from the chapter-opening list; worked examples from "প্রশ্ন:/Question:" inside example boxes; exercise items from the "নমুনা প্রশ্ন / Sample Questions" section. Running headers and footers removed.

4. Cross-check (pair.py): the English term printed in each Bangla heading is matched against the English book's heading with the same number. Agreement sets concept_key_checked.

5. Agent corrections (books/*.corrections.json): fixes made after looking at the page image (OCR-garbled headings and objectives, headings whose number OCR could not read, merged bullets). Each carries its reason and page and sets agent_checked: true; none sets verified. Real differences between the two printed books are recorded in books/physics-9-10.pairing.json.

6. Hand-check (review.py, apply_review.py): a review sheet and CSV; only a named human can set verified: true.

Data status

Coverage per chapter, Bangla / English (sections / objectives / worked examples / MCQ-creative-short items):

• Both books: 13 chapters, 190 sections, 98 worked-example pointers, 146 exercise-item pointers; 143 (bn) and 144 (en) objectives. The one count difference is in the printed books themselves (ch. 7: the English book lists one more outcome), confirmed on the page images.

• Section numbering differs in two places in the printed books (en skips 8.2.2 and 8.8.4), so bn 8.2.2/8.8.4 correspond to en 8.2.3/8.8.5.

• Chapter titles and start pages: checked by eye against both contents pages.

• Sections, objectives and counts: OCR + automatic bn/en cross-checks + agent corrections on page images (agent_checked). Remaining issues are listed per item in review.flags and in the review sheet.

• verified: true: 0 items. Nothing has been human-verified yet.

Develop

pnpm install
pnpm test          # vitest: tool behaviour + data invariants + JSON Schema
pnpm lint && pnpm format:check
pnpm build && node dist/cli.js --version
pnpm inspect       # MCP Inspector UI
npx @modelcontextprotocol/inspector --cli node dist/cli.js --method tools/list

Data lives in ../nctb-shared/data during development; pnpm sync-data copies it into data/, which is what the npm package ships.

Before publishing

Open decisions for the owner (see DATA_LICENSE.md): whether shipping the books' headings and learning-objective lines is acceptable without NCTB's permission, and which licence covers the metadata compilation. Until then there is no npm release.

Licence

Code: MIT. NCTB textbook content belongs to NCTB and is not covered by the MIT licence. Not affiliated with NCTB.