Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

VAT Sense (BYOK) — connector documentation

  • MCP endpoint: https://byok-vatsense.connectorbay.com/mcp
  • REST API: POST https://byok-vatsense.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-vatsense.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own VAT Sense VAT Sense API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-vatsense.connectorbay.com/health · Tool schemas: https://byok-vatsense.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-vatsense · agent@connectorbay.com

What VAT Sense (BYOK) is for

VAT Sense (BYOK) lets an AI assistant read your own VAT Sense data through the VAT Sense API with a key you supply (VAT Sense API key). Read-only: 12 tools (list_vat_rates, find_vat_rate, get_tax_rate_detail, list_rate_types, calculate_vat_price_for_country, list_countries, list_provinces, validate_vat_number, validate_eori_number, list_currency_rates, convert_currency, get_api_usage). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.vatsense.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by VAT Sense. VAT Sense and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "What are the VAT rates in France?"
  • "What VAT rate applies to ebooks in Germany?"
  • "Give me the full tax rate details for restaurants in Canada's Northwest Territories"
  • "Which product types can I look up special VAT rates for?"
  • "What is a 30.00 price excluding VAT in Spain with VAT added?"
  • "Which countries does VAT Sense cover and which are EU VAT countries?"

What it does

  • list_vat_rates: List VAT/GST rates by country: the standard rate plus other rate classes, optionally for one country, EU members only or a past date. Counts toward the monthly request quota.
  • find_vat_rate: Find the single rate that applies to a country (and province) for an optional product type, for example the reduced rate for books.
  • get_tax_rate_detail: Get the detailed tax rate for a location and optional product type, including rate class, tax name and description.
  • list_rate_types: List the product types that can be used to look up reduced or special VAT rates.
  • calculate_vat_price_for_country: Find the VAT rate for a country and optional product type and apply it to a price, returning prices with and without VAT.
  • list_countries: List countries with their ISO code, coordinates and whether they charge VAT/GST and belong to the EU VAT area.
  • list_provinces: List the provinces or states of a country, with their codes, as used for provincial tax lookups.
  • validate_vat_number: Check a VAT number against official records (UK HMRC, EU VIES, Australia, Norway, Switzerland, South Africa, Brazil) and return the registered business name and address. Counts toward the request quota.
  • validate_eori_number: Check an EORI customs number and return the registered business name and address. Counts toward the request quota.
  • list_currency_rates: List official conversion rates into GBP (HMRC monthly rates) or EUR (European Central Bank), optionally for given source currencies.
  • convert_currency: Convert an amount from a foreign currency into GBP or EUR with the official rate.
  • get_api_usage: Show how many VAT Sense requests the plan allows, how many were used in the last 30 days and how many remain.

BYOK key

You bring your own VAT Sense VAT Sense API key (https://vatsense.com/pricing). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.vatsense.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the VAT Sense API (api.vatsense.com) with a BYOK key; documentation: https://vatsense.com/documentation. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by VAT Sense. VAT Sense and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your VAT Sense account.

Built for: Worldwide. Languages: English.