{"openapi":"3.1.0","info":{"title":"Taxes API","version":"0.1.0","description":"Income-tax, HRA, GST and capital-gains calculators for India; US federal income tax with FICA; UK income tax and National Insurance; bundled rate tables.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://taxes.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/taxes/docs"},"termsOfService":"https://connectorbay.com/taxes/terms"},"servers":[{"url":"https://taxes.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/taxes/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/income_tax_india":{"post":{"operationId":"income_tax_india","summary":"Indian income tax under the new regime, the old regime, or both compared — slab breakdown, 87A rebate, surcharge,","description":"Indian income tax under the new regime, the old regime, or both compared — slab breakdown, 87A rebate, surcharge,\n    cess, effective rate and monthly take-home. Use for \"tax on 18 lakh new vs old\", \"is old regime better with 2 lakh\n    home-loan interest and 1.5 lakh 80C\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gross_income":{"description":"Annual gross income in ₹ (salary + other income).","maximum":10000000000.0,"minimum":0,"title":"Gross Income","type":"number"},"regime":{"default":"compare","description":"new | old | compare","title":"Regime","type":"string"},"age":{"default":35,"maximum":120,"minimum":0,"title":"Age","type":"integer"},"salaried":{"default":true,"description":"Salary/pension income (standard deduction applies).","title":"Salaried","type":"boolean"},"deductions_old":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"default":null,"description":"Old-regime deductions, e.g. {'80C': 150000, '80D self/family': 25000, '24(b) home loan interest (self-occupied)': 200000, 'HRA exempt': 120000}.","title":"Deductions Old"},"employer_nps":{"default":0,"description":"Employer NPS contribution (80CCD(2)).","minimum":0,"title":"Employer Nps","type":"number"},"other_exempt":{"default":0,"description":"Other exempt income/allowances already excluded.","minimum":0,"title":"Other Exempt","type":"number"},"year":{"default":"2026-27","description":"Financial year: 2025-26 | 2026-27","title":"Year","type":"string"}},"required":["gross_income"],"title":"income_tax_indiaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hra_exemption":{"post":{"operationId":"hra_exemption","summary":"HRA exemption under section 10(13A): the least of HRA received, rent minus 10% of salary, and 50%/40% of salary.","description":"HRA exemption under section 10(13A): the least of HRA received, rent minus 10% of salary, and 50%/40% of salary.\n    Use for \"HRA exemption: basic 60k/month, HRA 25k, rent 22k in Mumbai\" (give annual figures).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"basic":{"description":"Annual basic salary ₹.","exclusiveMinimum":0,"title":"Basic","type":"number"},"hra_received":{"description":"Annual HRA received ₹.","minimum":0,"title":"Hra Received","type":"number"},"rent_paid":{"description":"Annual rent paid ₹.","minimum":0,"title":"Rent Paid","type":"number"},"da":{"default":0,"description":"Annual dearness allowance (if part of retirement benefits).","minimum":0,"title":"Da","type":"number"},"metro":{"default":false,"description":"Living in Delhi, Mumbai, Kolkata or Chennai.","title":"Metro","type":"boolean"}},"required":["basic","hra_received","rent_paid"],"title":"hra_exemptionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gst_calc":{"post":{"operationId":"gst_calc","summary":"Add or remove GST at a rate with the CGST/SGST or IGST split; or look up which slab common goods and services","description":"Add or remove GST at a rate with the CGST/SGST or IGST split; or look up which slab common goods and services\n    fall in under the September-2025 GST 2.0 schedule. Use for \"GST on ₹1,200 at 18%\", \"price before GST of ₹5,900\",\n    \"what is GST on cement now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount":{"description":"Amount in ₹.","exclusiveMinimum":0,"title":"Amount","type":"number"},"rate":{"default":18,"description":"GST rate %: 0, 0.25, 3, 5, 18, 40 (any value accepted).","title":"Rate","type":"number"},"inclusive":{"default":false,"description":"True if the amount already includes GST (extract it).","title":"Inclusive","type":"boolean"},"interstate":{"default":false,"description":"Inter-state supply (IGST) instead of CGST+SGST.","title":"Interstate","type":"boolean"},"lookup":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Or ask which slab an item is in, e.g. 'cement', 'ghee', 'small car'.","title":"Lookup"}},"required":["amount"],"title":"gst_calcArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/capital_gains_india":{"post":{"operationId":"capital_gains_india","summary":"Capital-gains tax in India at post-July-2024 rates: equity/equity MF (20% STCG, 12.5% LTCG above ₹1.25 lakh),","description":"Capital-gains tax in India at post-July-2024 rates: equity/equity MF (20% STCG, 12.5% LTCG above ₹1.25 lakh),\n    debt MF (slab), property/gold/unlisted (12.5% LTCG after 24 months, slab for STCG), with cess. Use for \"tax on\n    selling shares bought 3 years ago for 2 lakh, sold at 5 lakh\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"asset":{"description":"equity | equity_mf | debt_mf | property | gold | unlisted","title":"Asset","type":"string"},"buy_price":{"minimum":0,"title":"Buy Price","type":"number"},"sell_price":{"minimum":0,"title":"Sell Price","type":"number"},"holding_months":{"maximum":1200,"minimum":0,"title":"Holding Months","type":"number"},"expenses":{"default":0,"description":"Brokerage, stamp duty, improvement cost.","minimum":0,"title":"Expenses","type":"number"},"other_ltcg_equity_used":{"default":0,"description":"₹1.25 lakh equity LTCG exemption already used this year.","minimum":0,"title":"Other Ltcg Equity Used","type":"number"}},"required":["asset","buy_price","sell_price","holding_months"],"title":"capital_gains_indiaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/income_tax_us":{"post":{"operationId":"income_tax_us","summary":"US federal income tax for 2025 or 2026 with bracket breakdown, standard vs itemized deduction, senior","description":"US federal income tax for 2025 or 2026 with bracket breakdown, standard vs itemized deduction, senior\n    deduction, long-term gains at 0/15/20%, FICA or self-employment tax, marginal and effective rates. Federal only.\n    Use for \"federal tax on $120k single in 2026\", \"married filing jointly $200k with $10k gains\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"income":{"description":"Annual gross income (wages/net self-employment) in $.","maximum":1000000000.0,"minimum":0,"title":"Income","type":"number"},"filing_status":{"default":"single","description":"single | married_joint | married_separate | head_of_household","title":"Filing Status","type":"string"},"year":{"default":"2026","description":"2025 | 2026","title":"Year","type":"string"},"itemized_deductions":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Total itemized deductions if higher than the standard.","title":"Itemized Deductions"},"age65_count":{"default":0,"description":"Number of filers aged 65+ (senior deduction).","maximum":2,"minimum":0,"title":"Age65 Count","type":"integer"},"self_employed":{"default":false,"description":"Compute self-employment tax instead of employee FICA.","title":"Self Employed","type":"boolean"},"long_term_gains":{"default":0,"description":"Long-term capital gains / qualified dividends.","minimum":0,"title":"Long Term Gains","type":"number"}},"required":["income"],"title":"income_tax_usArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/income_tax_uk":{"post":{"operationId":"income_tax_uk","summary":"UK income tax (personal allowance with the £100k taper, basic/higher/additional bands), employee National","description":"UK income tax (personal allowance with the £100k taper, basic/higher/additional bands), employee National\n    Insurance, student loan by plan, pension contribution, and monthly take-home for 2025/26 (frozen thresholds).\n    Use for \"take-home on £55,000 with a plan 2 loan and 5% pension\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"income":{"description":"Annual gross salary in £.","maximum":100000000.0,"minimum":0,"title":"Income","type":"number"},"student_loan":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"plan_1 | plan_2 | plan_4 | plan_5 | postgraduate","title":"Student Loan"},"pension_pct":{"default":0,"description":"Salary-sacrifice / net-pay pension contribution %.","maximum":100,"minimum":0,"title":"Pension Pct","type":"number"},"scotland":{"default":false,"description":"Flag if resident in Scotland (bands differ; result is rUK).","title":"Scotland","type":"boolean"}},"required":["income"],"title":"income_tax_ukArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tax_slabs":{"post":{"operationId":"tax_slabs","summary":"The bundled rate tables: Indian new/old regime slabs, deductions, surcharge, capital-gains and GST schedule; US","description":"The bundled rate tables: Indian new/old regime slabs, deductions, surcharge, capital-gains and GST schedule; US\n    federal brackets, standard deductions and FICA for 2025 and 2026; UK bands, NI and student-loan thresholds.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"default":"india","description":"india | us | uk","title":"Country","type":"string"}},"title":"tax_slabsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}