{
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
    "name": "com.zamcalc/calculators",
    "title": "Zamcalc Calculators",
    "description": "Zambian financial calculators - PAYE, NAPSA, NHIMA, ZESCO, mobile money fees, vehicle import duty, government bonds, gratuity, and live Kwacha exchange rates. All figures cite official Zambian sources (ZRA, NAPSA, NHIMA, ZESCO, BoZ).",
    "version": "1.0.0",
    "websiteUrl": "https://zamcalc.com",
    "repository": {
        "url": "https://github.com/blessedzulu/zamcalc",
        "source": "github"
    },
    "supportedProtocolVersions": [
        "2025-03-12"
    ],
    "capabilities": {
        "tools": {}
    },
    "tools": [
        {
            "name": "calculate_paye_zambia",
            "description": "Calculate Zambian PAYE income tax, NAPSA pension and NHIMA contributions for a monthly gross salary in Kwacha.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "gross": {
                        "type": "number",
                        "description": "Monthly gross salary in ZMW"
                    }
                },
                "required": [
                    "gross"
                ]
            }
        },
        {
            "name": "calculate_vehicle_import_duty_zambia",
            "description": "Estimate ZRA customs duty, excise duty, surtax, carbon tax and total landed cost for importing a used vehicle into Zambia.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "category": {
                        "type": "string",
                        "description": "Vehicle category: saloon, suv, pickup, truck, bus, motorcycle"
                    },
                    "ageYears": {
                        "type": "number",
                        "description": "Vehicle age in years (surtax kicks in over 5)"
                    },
                    "engineCc": {
                        "type": "number",
                        "description": "Engine displacement in cubic centimetres"
                    }
                }
            }
        },
        {
            "name": "calculate_mobile_money_fee_zambia",
            "description": "Calculate Airtel Money, MTN MoMo or Zamtel Kwacha send/withdrawal fees including the government Mobile Money Levy.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "amount": {
                        "type": "number",
                        "description": "Transaction amount in ZMW"
                    },
                    "provider": {
                        "type": "string",
                        "enum": [
                            "mtn",
                            "airtel",
                            "zamtel"
                        ]
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "send_same",
                            "send_cross",
                            "send_bank",
                            "withdraw"
                        ]
                    }
                },
                "required": [
                    "amount"
                ]
            }
        },
        {
            "name": "estimate_zesco_units_zambia",
            "description": "Estimate ZESCO Cash Power kWh units for a Kwacha top-up using the current ERB Residential Tariff bands.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "input": {
                        "type": "number",
                        "description": "Kwacha top-up amount"
                    }
                },
                "required": [
                    "input"
                ]
            }
        },
        {
            "name": "calculate_government_bonds_return_zambia",
            "description": "Estimate returns on GRZ Treasury Bonds across the 2, 3, 5, 7, 10 and 15-year tenors using the latest Bank of Zambia auction-cleared yield curve.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "principal": {
                        "type": "number",
                        "description": "Investment amount in ZMW"
                    },
                    "term": {
                        "type": "number",
                        "description": "Tenor in years: 2, 3, 5, 7, 10, or 15"
                    }
                },
                "required": [
                    "principal",
                    "term"
                ]
            }
        },
        {
            "name": "kwacha_exchange_rates",
            "description": "Get live ZMW (Zambian Kwacha) exchange rates against major currencies. Mid-market data refreshed every 2 hours from Open Exchange Rates.",
            "inputSchema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "name": "calculate_gratuity_zambia",
            "description": "Calculate end-of-contract gratuity for Zambian fixed-term contracts. Statutory minimum is 25% of total basic pay earned per Section 73 of the Employment Code Act.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "basicPay": {
                        "type": "number",
                        "description": "Monthly basic pay in ZMW"
                    },
                    "years": {
                        "type": "number",
                        "description": "Contract duration in years"
                    },
                    "months": {
                        "type": "number",
                        "description": "Additional months on top of years"
                    },
                    "rate": {
                        "type": "number",
                        "description": "Gratuity rate as decimal (0.25 = 25% minimum statutory)"
                    }
                },
                "required": [
                    "basicPay",
                    "years"
                ]
            }
        }
    ],
    "resources": [],
    "prompts": [],
    "icons": [],
    "remotes": [],
    "packages": [],
    "_meta": {
        "updated_at": "2026-05-11T17:36:12+02:00",
        "note": "Informational card per SEP-2127. Live MCP transport endpoint planned for a future release; tools are currently callable via the WebMCP advertisement on the Zamcalc homepage and the Markdown discovery surface."
    }
}