Withholding tax on a payment
calculate_withholding_taxThe tax to withhold on one payment from a country to a recipient resident in another country (or the same one): applies the domestic rate and, for a non-resident, the tax-treaty maximum (the lower one), and returns the rate, the amount withheld and the net payment, with the sources. With amount_is 'net', grosses the payment up. Where the data cannot decide (treaty rates by condition such as 5/15, several domestic rates), every option is returned with its condition; where a rate is not recorded, no amount is given.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>",
"payment_type": "<payment_type>",
"amount": "<amount>",
"recipient_country": "<recipient_country>"
},
"name": "calculate_withholding_tax"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional YYYY-MM-DD: use the rates in force on that date where a dated period covers it (otherwise no amount) | |
| amount | Yes | Payment amount in its currency | |
| country | Yes | Paying country (ISO 3166-1 alpha-2), e.g. KE | |
| amount_is | No | Optional: 'gross' (default, the amount before tax) or 'net' (the recipient must receive this amount; the payment is grossed up) | |
| payment_type | Yes | ||
| recipient_country | Yes | Recipient's country of residence (ISO code); the paying country itself for a resident recipient |