{"openapi":"3.1.0","info":{"title":"UAE VAT Threshold Monitor API","version":"0.1.0","description":"Tests a small business's monthly taxable supplies and imports against the UAE VAT registration thresholds published by the Federal Tax Authority and the Ministry of Finance: AED 375,000 mandatory and AED 187,500 voluntary (supplies and imports, or taxable expenses), over the previous 12 months and for the next 30 days. Shows headroom, the month a growth rate would cross the line, a one-call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://ae-vat-threshold.connectorbay.com/mcp.\n\nDisclaimer: General information only, not legal, tax, accounting or payment advice. UAE VAT Threshold Monitor is an independent tool: it is not affiliated with, endorsed by or operated by any government body, central bank, standards body or scheme operator. Rates, thresholds and rules change; check the cited official source and confirm with a qualified professional before you rely on a result.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/ae-vat-threshold/docs"},"termsOfService":"https://connectorbay.com/ae-vat-threshold/terms"},"servers":[{"url":"https://ae-vat-threshold.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/ae-vat-threshold/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/check_mandatory_threshold":{"post":{"operationId":"check_mandatory_threshold","summary":"Test monthly taxable supplies and imports against the AED 375,000 mandatory VAT registration threshold over the previous","description":"Test monthly taxable supplies and imports against the AED 375,000 mandatory VAT registration threshold over the previous 12 months and for the next 30 days. Use for \"My sales were 28,000 to 40,000 a month for the last 12 months: have I crossed the UAE VAT registration threshold?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"monthly_supplies":{"description":"Monthly taxable supplies and imports in AED (before VAT), oldest first, 1 to 36 decimal strings with a dot such as \"30000.00\"; the last 12 entries form the rolling window","items":{"type":"string"},"title":"Monthly Supplies","type":"array"},"last_month":{"description":"Calendar month of the LAST entry in the list, as YYYY-MM, for example 2026-09","title":"Last Month","type":"string"},"expected_supplies_next_30_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Taxable supplies and imports you expect in the next 30 days, AED decimal string; leave out to skip the forward test","title":"Expected Supplies Next 30 Days"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date the answer is for, YYYY-MM-DD; default today (the answer says which date it used)","title":"On Date"}},"required":["monthly_supplies","last_month"],"title":"check_mandatory_thresholdArguments","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/check_voluntary_eligibility":{"post":{"operationId":"check_voluntary_eligibility","summary":"Test taxable supplies and imports, or taxable expenses, against the AED 187,500 voluntary VAT registration threshold (pr","description":"Test taxable supplies and imports, or taxable expenses, against the AED 187,500 voluntary VAT registration threshold (previous 12 months and next 30 days). Use for \"My taxable expenses were about 10,000 a month: can I register for UAE VAT voluntarily?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"monthly_supplies":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Monthly taxable supplies and imports in AED, oldest first, up to 36 decimal strings; optional","title":"Monthly Supplies"},"monthly_expenses":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Monthly taxable expenses in AED, oldest first, same months as monthly_supplies when both are given; optional","title":"Monthly Expenses"},"last_month":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Calendar month of the LAST entry of each list, YYYY-MM; required when a list is given","title":"Last Month"},"expected_supplies_next_30_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Expected taxable supplies and imports in the next 30 days, AED; optional","title":"Expected Supplies Next 30 Days"},"expected_expenses_next_30_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Expected taxable expenses in the next 30 days, AED; optional","title":"Expected Expenses Next 30 Days"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date the answer is for, YYYY-MM-DD; default today (the answer says which date it used)","title":"On Date"}},"title":"check_voluntary_eligibilityArguments","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/registration_deadline":{"post":{"operationId":"registration_deadline","summary":"Compute the 30-day application date after the mandatory threshold was crossed or expected to be crossed, with days remai","description":"Compute the 30-day application date after the mandatory threshold was crossed or expected to be crossed, with days remaining (the 30-day period is stated on one FTA page; its anchor date is not defined). Use for \"We crossed AED 375,000 on 30 September 2026: by what date do we have to apply for VAT registration?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"basis":{"description":"past_12_months (the trailing 12-month total exceeded the threshold) or next_30_days (you first expected to exceed it within 30 days)","title":"Basis","type":"string"},"date_reached":{"description":"The date the threshold was crossed (past_12_months) or the date you first expected to cross it (next_30_days), YYYY-MM-DD","title":"Date Reached","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date the answer is for, YYYY-MM-DD; default today (the answer says which date it used)","title":"On Date"}},"required":["basis","date_reached"],"title":"registration_deadlineArguments","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/threshold_headroom":{"post":{"operationId":"threshold_headroom","summary":"Remaining headroom to AED 375,000 on the rolling 12-month total and the month it is projected to be crossed at an assume","description":"Remaining headroom to AED 375,000 on the rolling 12-month total and the month it is projected to be crossed at an assumed monthly growth rate. Use for \"How much room do I have before the UAE VAT threshold and when will I pass it if sales grow 2% a month?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"monthly_supplies":{"description":"Monthly taxable supplies and imports in AED (before VAT), oldest first, 1 to 36 decimal strings with a dot such as \"30000.00\"; the last 12 entries form the rolling window","items":{"type":"string"},"title":"Monthly Supplies","type":"array"},"last_month":{"description":"Calendar month of the LAST entry in the list, as YYYY-MM, for example 2026-09","title":"Last Month","type":"string"},"monthly_growth_percent":{"default":"0","description":"Assumed monthly growth of supplies in percent as a decimal string, for example 2.5 (default 0 = flat at the latest month; negative allowed, -50 to 100)","title":"Monthly Growth Percent","type":"string"},"horizon_months":{"default":24,"description":"How many months ahead to project, 1 to 36 (default 24)","title":"Horizon Months","type":"integer"}},"required":["monthly_supplies","last_month"],"title":"threshold_headroomArguments","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/weekly_threshold_report":{"post":{"operationId":"weekly_threshold_report","summary":"One summary for a scheduled weekly run: mandatory and voluntary tests, headroom, projected crossing month and what the r","description":"One summary for a scheduled weekly run: mandatory and voluntary tests, headroom, projected crossing month and what the rule says. Use for \"Give me this week's UAE VAT threshold check from my monthly sales\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"monthly_supplies":{"description":"Monthly taxable supplies and imports in AED (before VAT), oldest first, 1 to 36 decimal strings with a dot such as \"30000.00\"; the last 12 entries form the rolling window","items":{"type":"string"},"title":"Monthly Supplies","type":"array"},"last_month":{"description":"Calendar month of the LAST entry in the list, as YYYY-MM, for example 2026-09","title":"Last Month","type":"string"},"monthly_expenses":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Monthly taxable expenses in AED, oldest first, same months as monthly_supplies; optional (adds the voluntary expenses test)","title":"Monthly Expenses"},"expected_supplies_next_30_days":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Expected taxable supplies and imports in the next 30 days, AED; optional","title":"Expected Supplies Next 30 Days"},"monthly_growth_percent":{"default":"0","description":"Assumed monthly growth of supplies in percent as a decimal string, for example 2.5 (default 0 = flat at the latest month; negative allowed, -50 to 100)","title":"Monthly Growth Percent","type":"string"},"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date the answer is for, YYYY-MM-DD; default today (the answer says which date it used)","title":"On Date"}},"required":["monthly_supplies","last_month"],"title":"weekly_threshold_reportArguments","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/vat_rate_reference":{"post":{"operationId":"vat_rate_reference","summary":"UAE VAT standard rate (5% since 1 January 2018), the zero-rated categories named by the Ministry of Finance, and the ret","description":"UAE VAT standard rate (5% since 1 January 2018), the zero-rated categories named by the Ministry of Finance, and the return due-date rule. Use for \"What is the UAE VAT rate, what is zero-rated, and when is a VAT return due?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date the answer is for, YYYY-MM-DD; default today (the answer says which date it used)","title":"On Date"}},"title":"vat_rate_referenceArguments","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/threshold_reference":{"post":{"operationId":"threshold_reference","summary":"The two UAE VAT registration thresholds (AED 375,000 mandatory, AED 187,500 voluntary) with the exact test wording, sour","description":"The two UAE VAT registration thresholds (AED 375,000 mandatory, AED 187,500 voluntary) with the exact test wording, source and page date. Use for \"What are the UAE VAT registration thresholds and how are they tested?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"threshold_referenceArguments","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}}}}