Skip to content
Back to search

bangla-calendar-mcp

MCP server for the Bangladesh Bengali calendar, national days, districts and mobile numbers - with an eval that measures how much it helps an AI agent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/fasami--bangla-calendar-mcp/badge.svg)](/listings/fasami--bangla-calendar-mcp)

HTML

<a href="/listings/fasami--bangla-calendar-mcp"><img src="/api/listings/fasami--bangla-calendar-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 104 lines
  1. # bangla-calendar-mcp
  2. [![CI](https://github.com/FAsami/bangla-calendar-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/FAsami/bangla-calendar-mcp/actions/workflows/ci.yml)
  3. An [MCP](https://modelcontextprotocol.io) server that gives AI agents reliable answers about Bangladesh:
  4. the official Bengali calendar, fixed national days, the 64 districts, and mobile numbers.
  5. It comes with an **eval** that measures how much the tools help, against the same model without them.
  6. Language models often get Bengali calendar conversion wrong. Bangladesh uses its own revised calendar,
  7. which differs from the one used in West Bengal, so a model that half-remembers either one ends up off by a
  8. day or a month. This server computes the answer instead.
  9. ## Tools
  10. | Tool | What it does |
  11. | --- | --- |
  12. | `gregorian_to_bangla` | `2025-12-16` → 1 Poush 1432, Sheet (winter), Tuesday, `১ পৌষ ১৪৩২` |
  13. | `bangla_to_gregorian` | 8 Falgun 1432 → `2026-02-21` (month as 1-12, English, or Bengali script) |
  14. | `bd_national_days` | Fixed-date national days for a year, with weekday and Bengali date |
  15. | `bd_district` | District → division, accepting old spellings (Comilla, Jessore, Bogra…), or all 64 |
  16. | `bd_mobile_number` | Validates a number in any format and returns its operator and E.164 form |
  17. | `to_bangla_digits` | `2026` → `২০২৬` |
  18. All tools are read-only and need no network or API key.
  19. ## Use it
  20. **Claude Code**
  21. ```bash
  22. claude mcp add bangla-calendar -- npx -y github:FAsami/bangla-calendar-mcp
  23. ```
  24. **Claude Desktop and other MCP clients** (`claude_desktop_config.json`):
  25. ```json
  26. {
  27. "mcpServers": {
  28. "bangla-calendar": {
  29. "command": "npx",
  30. "args": ["-y", "github:FAsami/bangla-calendar-mcp"]
  31. }
  32. }
  33. }
  34. ```
  35. ## Calendar rules
  36. Bangladesh's calendar follows the Bangla Academy's 2019 revision:
  37. - The year starts on **14 April** (Pohela Boishakh). Bengali year = Gregorian year − 593 from 14 April.
  38. - **Boishakh to Ashshin** (months 1–6) have **31 days**.
  39. - **Falgun** has **29 days**, or **30** in a Gregorian leap year.
  40. - Every other month has **30 days**.
  41. These rules keep national days on fixed Bengali dates: 21 February = 8 Falgun, 26 March = 12 Choitro,
  42. 16 December = 1 Poush. The tests check those anchors, historical weekdays (21 February 1952 and
  43. 16 December 1971 were both Thursdays), and a round trip through every day from 1990 to 2060.
  44. ## Eval
  45. `eval/` asks Claude 50 questions twice, once **without tools** and once **with this server's tools**,
  46. using the same system prompt. Answers are graded by code, not by another model, so runs are reproducible.
  47. | Question type | Count | Example |
  48. | --- | --- | --- |
  49. | Gregorian → Bengali | 20 | What is the Bengali date for 2026-03-16? |
  50. | Bengali → Gregorian | 12 | Which Gregorian date is 29 Ashshin 1431? |
  51. | Weekday of a Bengali date | 6 | On which weekday does 1 Joishtho 1435 fall? |
  52. | District → division | 6 | Which division is "Jessore" in? |
  53. | Mobile operator | 6 | Which operator does +880 1912 345678 belong to? |
  54. ```bash
  55. export ANTHROPIC_API_KEY=... # or sign in with `ant auth login`
  56. pnpm eval -- --limit 5 # quick trial
  57. pnpm eval # all 50; prints a Markdown table
  58. EVAL_MODEL=claude-haiku-5-5 pnpm eval # compare a smaller model
  59. ```
  60. ### Results
  61. _Not run yet: results will be added here with the model, effort level and date._
  62. Expected answers come from the same code the tools use. That code is pinned to the official anchor
  63. dates above by the tests, but the eval measures whether the agent **uses** the tools correctly, not whether
  64. the calendar rules themselves are right.
  65. ## Limits
  66. - Lunar holidays (the two Eids, Shab-e-Barat, Ashura, Eid-e-Milad-un-Nabi) depend on moon sighting and are
  67. not included. Check the government's yearly holiday list for those.
  68. - The calendar rules apply from 1426 BS (2019) onwards. Dates before 2019 are converted with the same rules,
  69. which may differ by a day from what was printed at the time.
  70. ## Development
  71. ```bash
  72. pnpm install
  73. pnpm test # Vitest
  74. pnpm typecheck
  75. pnpm build && pnpm start
  76. ```
  77. MIT licensed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.