MCP · Model Context Protocol

Klar, built for AI agents

36 deterministic calculators — finance, pricing, health, education, plus Jordan & GCC labour-law and tax — callable directly by any AI agent over a secure MCP endpoint. Your agent gets the same engine the website uses.

Why this exists

Language models can do generic arithmetic in their heads — but they cannot reliably compute country-specific statutory figures. Klar can. That is the point.

The wedge

GCC & Jordan statutory pay

End-of-service gratuity, income tax, social insurance, notice period, maternity leave, overtime, and gross-to-net — for jo, sa, ae, kw, qa, bh, om — from embedded labour-law rules.

Trustworthy

One source of truth

The MCP tools call the very same calculation engines that power the Klar website. No duplicated formulas, no drift.

Agent-native

Structured, self-describing

Every result carries labels, units, currency, a primary answer, assumptions, and limitations — so an agent understands the number without seeing the site.

Connect your agent

Standard MCP over Streamable HTTP. Point any MCP-capable client at the endpoint and send your API key as a Bearer token.

Endpoint
https://mcp.worldly.pro/mcp
Transport
MCP Streamable HTTP (JSON)
Auth
Authorization: Bearer <API_KEY>
Tools
36 calculators

Access is currently invite-based while we gather usage. Request a free key at the email below — tell us what you are building. contact@worldly.pro

{
  "mcpServers": {
    "klar": {
      "url": "https://mcp.worldly.pro/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Example

Ask your agent:

“An employee in Jordan ends after 5 years on a 1,500 JOD basic salary — what is the end-of-service gratuity?”

The agent calls klar_calculate_end_of_service and gets:

{
  "calculator": { "slug": "end-of-service", "category": "employment-law" },
  "answers": [
    { "key": "gratuity", "label": "End-of-service gratuity",
      "value": 7500, "displayValue": "7500 JOD", "hero": true }
  ],
  "estimate": true,
  "jurisdiction": {
    "country": "jo", "currency": "JOD",
    "basis": "statutory", "rulesSnapshot": true,
    "legalNote": "Statutory estimate for JO — not legal advice."
  }
}

What's inside

36 tools across six categories. Each is deterministic and returns the same value as the Klar website.

Employment law · GCC

end-of-service, income tax, social insurance, gross-to-net, notice period, maternity leave, leave balance, overtime pay

Finance

loan payment, mortgage, loan comparison, early payoff, compound interest, retirement savings, savings goal, debt-to-income

Pricing & business

VAT, discount & percent change, markup & margin, selling price from markup, break-even, wholesale/retail

Work & pay

salary converter, employee cost, freelance rate

Health

BMI, BMR & TDEE, calorie intake, body fat, ideal weight (screening estimates, not medical advice)

Everyday & tools

tip, age, date difference, GPA, grade average, final grade, unit conversion

Streamable HTTPStatelessBearer authRate-limitedjo · sa · ae · kw · qa · bh · om

Good to know

Estimates, not advice

Statutory (labour-law/tax) results are estimates from an embedded rules snapshot — not legal or tax advice. Verify current law before relying on them.

Health is screening only

Health tools return screening estimates from named formulas — not a diagnosis or individualized medical advice.

No data stored

Calculations are ephemeral. Inputs are not logged or retained.