Tip Calculator: API and MCP

Tip Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: finance.tip
Version: 1.0.0
Access: Free
Tool page: Tip Calculator
Schema: GET /api/v1/tools/finance.tip

Input

Field	Type	Constraints	Default	Description
`bill` (required)	number	> 0, ≤ 1,000,000,000		Bill amount · The amount on the receipt, tax included
`tipType`	string	percent \| amount	percent	Tip type
`tipPercent`	number	≥ 0, ≤ 100		Tip percent (%)
`tipAmount`	number	≥ 0, ≤ 1,000,000,000		Tip amount
`people`	integer	≥ 1, ≤ 100	1	Number of people
`tipBase`	string	bill \| beforeTax	bill	Tip on
`taxRate`	number	≥ 0, ≤ 100		Tax rate in the bill (%) · Sales tax or VAT
`rounding`	string	none \| up	none	Share per person

Output

Field	Type	Description
`tip`	number	Tip
`tipPercent`	number	Tip percent (%)
`total`	number	Total (bill + tip)
`share`	number	Share per person
`tipPerPerson`	number	Tip per person
`taxAmount`	number	Tax in the bill
`base`	number	Amount before tax
`roundedShare`	number	Share per person (rounded)
`roundedTotal`	number	Total (rounded)
`roundingDifference`	number	Rounding difference
`roundedTip`	number	Tip with rounding
`roundedTipPercent`	number	Tip percent with rounding (%)

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/finance.tip/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"bill":1200,"tipType":"percent","tipPercent":10,"people":4,"tipBase":"bill","rounding":"none"},"locale":"en"}'

Example answer

{
  "output": {
    "tip": 120,
    "tipPercent": 10,
    "total": 1320,
    "share": 330,
    "tipPerPerson": 30
  },
  "steps": [
    {
      "id": "tip",
      "formula": "tip = bill × tip percent / 100",
      "substitution": "tip = 1,200.00 × 10 / 100",
      "value": 120
    },
    {
      "id": "total",
      "formula": "total = bill + tip",
      "substitution": "total = 1,200.00 + 120.00",
      "value": 1320
    },
    {
      "id": "share",
      "formula": "share per person = total / people",
      "substitution": "share per person = 1,320.00 / 4",
      "value": 330
    },
    {
      "id": "tipPerPerson",
      "formula": "tip per person = tip / people",
      "substitution": "tip per person = 120.00 / 4",
      "value": 30
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/finance/tip-calculator",
    "title": "Tip Calculator"
  }
}