compute_income_tax
PAID ($0.05). Statutory income tax on a TAXABLE-income figure using the country's verified marginal bracket schedule, with full per-bracket workings, effective rate and marginal rate. Handles inflation-indexed tax units (Colombia UVT, Chile UTA, Peru UIT, Uruguay BPC) — you pass local currency. IMPORTANT: this is tax on taxable income, NOT net take-home pay — reliefs/allowances and social-security contributions are the caller's concern and are not applied (see the response scope_note). 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 |
|---|---|---|---|
| api_key | No | API key (bypasses x402; metered for invoicing) | |
| country | Yes | ISO country code | |
| 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). | |
| taxable_income | Yes | Taxable income in the country's local currency, in the schedule's own period basis (annual for most; monthly for Côte d'Ivoire, Uganda, Ethiopia, Costa Rica) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tax | No | ||
| 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 | ||
| breakdown | No | ||
| no_charge | No | ||
| price_usd | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| provenance | No | Cited official sources behind the answer | |
| scope_note | No | ||
| 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 | ||
| marginal_rate | 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 | |
| effective_rate | No | ||
| 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 |