bangla-calendar
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bangla-calendar what's the Bengali date for 16 December 2026?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bangla-calendar-mcp
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 |
|
|
| 8 Falgun 1432 → |
| Fixed-date national days for a year, with weekday and Bengali date |
| District → division, accepting old spellings (Comilla, Jessore, Bogra…), or all 64 |
| Validates a number in any format and returns its operator and E.164 form |
|
|
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-mcpClaude 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 modelResults
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 startMIT licensed.
Available Tools
6 toolsbangla_to_gregorianARead-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_districtARead-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_numberARead-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_daysARead-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_banglaARead-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_digitsBRead-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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
500+ deterministic tools for AI agents: math, conversion, validation, hashing, encoding, date/time.
Everyday calculators and converters for AI assistants: units, dates, percentages, text, JSON.
Free deterministic tools for math, data transforms, dates, text, statistics, finance, and units.
Indonesian public data, QRIS, rupiah and AI model status tools. No API key needed.
241
Related MCP Servers
- AlicenseBqualityAmaintenanceEnables 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.40MIT
- AlicenseAqualityCmaintenanceEnables 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.131MIT
- AlicenseAqualityBmaintenanceEnables 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.17MIT
- AlicenseAqualityBmaintenanceEnables 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.845 npmMIT