Skip to main content
Glama
MCP Urdu Toolkit

MCP Urdu Toolkit

MCP Urdu Toolkit

An MCP server that gives Claude (and any MCP client) reliable Pakistan/Urdu helpers: phone numbers, Urdu digits, Hijri dates and lakh/crore rupee formatting.

mcp python license

LLMs often get these small local details wrong (Rs 1,250,000 instead of Rs 12,50,000, mixed digit scripts, invalid phone formats). This server makes them deterministic.

Tools

Tool

Example

normalize_pk_phone

0333-1234567 → +923331234567, mobile, originally Ufone · 042-35761234 → landline, Lahore

convert_digits

Rs 2026 ↔ Rs ۲۰۲۶

urdu_text_stats

words, characters, Urdu vs Roman script, reading time

hijri_date

2000-01-01 → 24 Ramazan 1420 AH / ۲۴ رمضان ۱۴۲۰ ہجری (tabular, with offset_days for moon sighting)

format_pkr

1250000 → Rs 12,50,000 · 12 lakh 50 hazar

Related MCP server: Claude MCP Server

Install

pip install git+https://github.com/SameerD2logix/mcp-urdu-toolkit

Claude Code

claude mcp add urdu-toolkit -- mcp-urdu-toolkit

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "urdu-toolkit": { "command": "mcp-urdu-toolkit" }
  }
}

Then ask: "Format 2.5 crore in rupees and convert the year to Urdu digits" or "Clean these phone numbers".

Design

  • tools.py: pure functions, no MCP imports, easy to test and reuse in other Python code.

  • server.py: thin MCP layer (official mcp Python SDK v2, stdio transport).

  • No network access, no data stored. Everything runs locally.

Development

pip install -e . pytest
pytest -q

Author

Sameer Hussain · LinkedIn · D2Logix

Available Tools

5 tools
convert_digitsA

Convert the digits in text to Urdu digits (to="urdu") or back to 0-9 (to="latin").

Inputs: text (required), to. Returns: result

format_pkrB

Format a rupee amount with lakh/crore grouping, e.g. 1250000 -> "Rs 12,50,000" / "12 lakh 50 hazar".

Inputs: amount (required), words.

hijri_dateA

Approximate Hijri (Islamic) date for an ISO date (YYYY-MM-DD, default today), in English and Urdu. Use offset_days (e.g. -1) to match the local moon-sighting calendar.

Inputs: date, offset_days.

normalize_pk_phoneA

Normalise a Pakistani phone number (any format, Latin or Urdu digits) to +92 E.164, and say if it is a mobile (with its original network) or a landline (with its city).

Inputs: phone (required).

urdu_text_statsC

Count words and characters, detect Urdu vs Roman/Latin script, and estimate reading time.

Inputs: text (required), words_per_minute.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a clearly distinct operation: phone normalisation, digit conversion, text statistics, date conversion, and currency formatting. No two tools overlap in input type or purpose, so an agent can select the right one without hesitation.

    Naming Consistency4/5

    All names are lowercase snake_case with predictable, descriptive wording. There is a minor split between verb-first names (normalize_pk_phone, convert_digits, format_pkr) and noun-first names (urdu_text_stats, hijri_date), but all remain readable and unambiguous.

    Tool Count5/5

    Five tools is a well-scoped set for a localisation utility toolkit, and each tool covers a genuinely different need. Nothing feels padded or missing at the surface level.

    Completeness4/5

    The tools cover the main Pakistan/Urdu utility cases (phones, digits, text stats, dates, currency) with no dead ends since each is self-contained. Minor gaps exist, such as parsing/normalising currency strings or converting Roman Urdu transliteration back to script.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides a suite of deterministic tools for time calculations, math, and string manipulation that LLMs often struggle to perform accurately. It also includes utilities for secure randomness, data validation, and basic network operations like DNS lookups.
      6 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to perform file operations, retrieve system information, run calculations, and generate timestamps on the local system.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to work with Iran-specific data and Persian/RTL frontends fully offline, covering Jalali date conversion, national ID, card, Sheba and mobile validation, Persian text and number formatting, bank and operator lookup, VAT and price handling, plus RTL auditing and CSS/Tailwind conversion. All tools run locally with no API keys.
      56
      54 npm
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude and other MCP-compatible AI assistants to create GST invoices, calculate GST, validate GSTINs, search HSN/SAC codes, and analyze PDF or CSV bank statements with decoded UPI narrations. It also supports IFSC and PIN code lookups, with most sensitive financial processing done locally.
      12
      573 npm
      MIT