compute_payroll
PAID ($0.10). Gross-to-net take-home pay for Nigeria or Kenya: applies PAYE (on the verified brackets) plus the statutory employee deductions (Nigeria: pension/NHF/NHIS; Kenya: NSSF/SHIF/Affordable Housing Levy) and reliefs, returning net pay with full workings, per-contribution citations and DISCLOSED assumptions. Nigeria's pension base needs pay composition — pass basic/housing/transport for an exact figure, or a market-convention 40/30/10 split is assumed and disclosed. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series). Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.25 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| basic | No | Nigeria: basic pay component | |
| gross | Yes | Gross pay in local currency | |
| period | No | Period the gross covers (default month) | |
| sector | No | Nigeria: public applies NHF; private (default) sets NHF 0 | |
| api_key | No | API key (bypasses x402; metered for invoicing) | |
| country | Yes | Payroll is supported for Nigeria (ng) and Kenya (ke) | |
| housing | No | Nigeria: housing allowance | |
| receipt | No | Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.25; that SKU is not an MCP tool). | |
| transport | No | Nigeria: transport allowance | |
| annual_rent | No | Nigeria: annual rent paid (unlocks rent relief) | |
| nhis_premium | No | Nigeria: NHIS employee premium if deducted | |
| pensionable_pay | No | Kenya: pensionable pay for NSSF tiers | |
| insurance_premium | No | Kenya: insurance premium for 15% relief |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| basis | No | ||
| error | No | Present on a free refusal or error; no charge | |
| status | No | Answer status, e.g. computed or an honest no-answer status | |
| country | No | ||
| receipt | No | Ed25519 answer receipt when receipt=true on a paid success | |
| question | No | ||
| no_charge | No | ||
| price_usd | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| provenance | No | Cited official sources behind the answer | |
| bind_series | No | ||
| explanation | No | ||
| label_basis | No | Inputs and the rule ids that produced the two labels | |
| x_next_bind | No | ||
| http_endpoint | No | ||
| coverage_label | No | How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules | |
| confidence_label | No | Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules | |
| payment_required | No | true when the call needs payment; how_to_pay explains x402 or card |