Skip to main content
Glama
bangla-calendar
by FAsami

bangla-calendar-mcp

CI

An MCP server that gives AI agents reliable answers about Bangladesh: the official Bengali calendar, fixed national days, the 64 districts, and mobile numbers. It comes with an eval that measures how much the tools help, against the same model without them.

Language models often get Bengali calendar conversion wrong. Bangladesh uses its own revised calendar, which differs from the one used in West Bengal, so a model that half-remembers either one ends up off by a day or a month. This server computes the answer instead.

Tools

Tool

What it does

gregorian_to_bangla

2025-12-16 → 1 Poush 1432, Sheet (winter), Tuesday, ১ পৌষ ১৪৩২

bangla_to_gregorian

8 Falgun 1432 → 2026-02-21 (month as 1-12, English, or Bengali script)

bd_national_days

Fixed-date national days for a year, with weekday and Bengali date

bd_district

District → division, accepting old spellings (Comilla, Jessore, Bogra…), or all 64

bd_mobile_number

Validates a number in any format and returns its operator and E.164 form

to_bangla_digits

2026 → ২০২৬

All tools are read-only and need no network or API key.

Related MCP server: cn-dev-mcp

Use it

Claude Code

claude mcp add bangla-calendar -- npx -y github:FAsami/bangla-calendar-mcp

Claude Desktop and other MCP clients (claude_desktop_config.json):

{
  "mcpServers": {
    "bangla-calendar": {
      "command": "npx",
      "args": ["-y", "github:FAsami/bangla-calendar-mcp"]
    }
  }
}

Calendar rules

Bangladesh's calendar follows the Bangla Academy's 2019 revision:

  • The year starts on 14 April (Pohela Boishakh). Bengali year = Gregorian year − 593 from 14 April.

  • Boishakh to Ashshin (months 1–6) have 31 days.

  • Falgun has 29 days, or 30 in a Gregorian leap year.

  • Every other month has 30 days.

These rules keep national days on fixed Bengali dates: 21 February = 8 Falgun, 26 March = 12 Choitro, 16 December = 1 Poush. The tests check those anchors, historical weekdays (21 February 1952 and 16 December 1971 were both Thursdays), and a round trip through every day from 1990 to 2060.

Eval

eval/ asks Claude 50 questions twice, once without tools and once with this server's tools, using the same system prompt. Answers are graded by code, not by another model, so runs are reproducible.

Question type

Count

Example

Gregorian → Bengali

20

What is the Bengali date for 2026-03-16?

Bengali → Gregorian

12

Which Gregorian date is 29 Ashshin 1431?

Weekday of a Bengali date

6

On which weekday does 1 Joishtho 1435 fall?

District → division

6

Which division is "Jessore" in?

Mobile operator

6

Which operator does +880 1912 345678 belong to?

export ANTHROPIC_API_KEY=...         # or sign in with `ant auth login`
pnpm eval -- --limit 5               # quick trial
pnpm eval                            # all 50; prints a Markdown table
EVAL_MODEL=claude-haiku-5-5 pnpm eval   # compare a smaller model

Results

Not run yet: results will be added here with the model, effort level and date.

Expected answers come from the same code the tools use. That code is pinned to the official anchor dates above by the tests, but the eval measures whether the agent uses the tools correctly, not whether the calendar rules themselves are right.

Limits

  • Lunar holidays (the two Eids, Shab-e-Barat, Ashura, Eid-e-Milad-un-Nabi) depend on moon sighting and are not included. Check the government's yearly holiday list for those.

  • The calendar rules apply from 1426 BS (2019) onwards. Dates before 2019 are converted with the same rules, which may differ by a day from what was printed at the time.

Development

pnpm install
pnpm test        # Vitest
pnpm typecheck
pnpm build && pnpm start

MIT licensed.

Available Tools

6 tools
bangla_to_gregorianA
Read-only

Convert a Bangladesh Bengali calendar date to a Gregorian date (YYYY-MM-DD). Month can be 1-12 (Boishakh = 1), an English spelling such as 'Poush', or Bengali script.

Inputs: day (required), year (required), month (required).

bd_districtA
Read-only

Look up a Bangladeshi district and its division. Accepts old spellings (Comilla, Jessore, Bogra, Chittagong, Barisal). Leave name empty to list all 64 districts by division.

Inputs: name.

bd_mobile_numberA
Read-only

Validate a Bangladeshi mobile number in any common format and return its operator (Grameenphone, Banglalink, Robi, Airtel, Teletalk) and normalised forms.

Inputs: number (required).

bd_national_daysA
Read-only

List Bangladesh's fixed-date national days for a Gregorian year, with weekday and Bengali date. Lunar holidays such as the Eids are not included because they depend on moon sighting.

Inputs: year (required).

gregorian_to_banglaA
Read-only

Convert a Gregorian date to the Bangladesh Bengali calendar (Bangla Academy 2019 revision). Returns the Bengali day, month, year, season (ritu) and weekday, in English and Bengali script.

Inputs: date (required).

to_bangla_digitsB
Read-only

Write a number or text with Bengali digits (০-৯) instead of 0-9.

Inputs: text (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: the two conversion tools are explicit inverses, and national days, district lookup, mobile validation, and digit conversion are non-overlapping utilities. An agent should have no trouble selecting the right tool.

    Naming Consistency3/5

    All names use snake_case, but the set mixes several naming conventions: source_to_target conversions, bd_ noun phrases, and a to_bangla_digits verb-like phrase. It remains readable, but there is no single predictable pattern across all six tools.

    Tool Count5/5

    Six tools is a well-scoped size for a Bangladesh calendar and locale utility server. Each tool appears to earn its place, with no excessive surface area or thin single-tool scope.

    Completeness4/5

    The calendar conversion lifecycle is covered in both directions, and district and mobile lookup utilities are fairly complete. Minor gaps exist, such as no reverse Bengali-digit conversion and no lunar holiday support, though the latter is explicitly excluded for moon-sighting reasons.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      Enables AI agents to build and parse VietQR payments, convert old 63-province addresses to the 34-province structure, validate tax IDs and e-invoices, turn money amounts into Vietnamese words, and convert between solar and lunar calendar dates. All tools run offline with bundled data, returning structured ok/error results.
      40
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables offline, fully local lookups and validations tuned for Chinese development work: statutory holiday and adjusted-workday checks, workday arithmetic, ID card/USCC/mobile format validation, Chinese-to-pinyin conversion, lunar-solar date conversion, and administrative region queries. It also provides searchable summaries of common uni-app, mini program, Element Plus, and Vant APIs, so assistants can answer these questions without any network calls or third-party services.
      13
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to query Türkiye-specific data and logic without API keys: official central-bank exchange rates and currency conversion, live AFAD/Kandilli earthquakes, the official holiday calendar with business-day math, IBAN/TCKN/VKN validation, province and district lookup, prayer times, weather forecasts, plus Turkish-correct text casing and amounts written out in words. All 17 tools are read-only, with most working fully offline.
      17
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to validate Indian identifiers (GSTIN, PAN, Aadhaar format, IFSC) and look up pincodes, state/GST codes, Central Government holidays, and compliance due dates entirely offline. Every result is deterministic and carries its data source and freshness, while making clear that a well-formed number is not proof of registration.
      8
      45 npm
      MIT