Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Sales Tax Calculator API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fsalestaxcalculatorapi.com%2Fsalestaxcalculatorapi" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fsalestaxcalculatorapi.com%2Fsalestaxcalculatorapi" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Sales Tax Calculator API.
Calculate sales tax, VAT, or GST for a sale from seller, customer, ship_to, and line items, with exclusive or inclusive tax_behavior
Tag the billing_event, such as one_time_charge, subscription_renewal, metered_usage, or proration, so the right rules apply
Read the outcome on each calculation and line, including not_obligated, reverse_charge_or_self_assess, and review_required
Finalise a calculation as a transaction with its calculation_id and your own reference
GET STARTED
Record adjustments against a transaction with a reason and lines for refunds or corrections
Submit many calculations at once as a calculation batch and retrieve the batch results
Check coverage for a country, optional state, tax_code, and transaction_type before calculating
Patterns agents use Sales Tax Calculator API for, with concrete tasks.
★ AI agent checkout tax step
An AI agent building a quote or checkout needs a tax figure it can trust or flag. Through Jentic the agent searches for 'calculate sales tax', loads createCalculation with its input schema, and sends currency, tax_behavior, billing_event, seller, customer, and lines with a fresh Idempotency-Key while the bearer key is injected at call time. It reads the outcome before quoting the total, and escalates when the outcome is review_required.
POST /v1/calculations for a 100.00 CAD one_time_charge with exclusive tax_behavior and one line, then report tax and total only if outcome is calculated
Subscription billing tax
SaaS billing has to tax trials, renewals, proration, and metered usage differently. The calculation request takes a billing_event such as subscription_start, subscription_renewal, metered_usage, free_trial, or proration, so a billing system can price each invoice line correctly and save it as a transaction once charged.
Calculate tax for a subscription_renewal line, then POST /v1/transactions with the calculation_id and an invoice reference
Refunds and corrections
When an order is partially refunded, the tax record has to change with it. POST /v1/transactions/{transaction_id}/adjustments records a correction with a required reference, reason, and lines, and the adjustments list gives an audit trail of every change to the finalised transaction.
Create an adjustment on a transaction for a refunded line with a reason and reference, then list adjustments to confirm it was recorded
Coverage check before launch
Before selling into a new market, a team needs to know whether the API covers it. GET /v1/coverage takes a required country, tax_code, and transaction_type, plus optional state, customer_type, and date, and answers whether calculations there are supported.
Call GET /v1/coverage for country AU with a tax_code, transaction_type sale, and customer_type consumer, and report whether it is supported
10 endpoints — the sales tax calculator api calculates sales tax, vat, and gst for a sale from its seller, customer, ship-from and ship-to addresses, and line items, returning tax, totals, and a per-line explanation.
METHOD
PATH
DESCRIPTION
/v1/calculations
Create a sales tax calculation
/v1/calculations/{calculation_id}
Retrieve a calculation
/v1/transactions
Create a transaction
/v1/transactions/{transaction_id}/adjustments
Create an adjustment
/v1/calculation-batches
Create a calculation batch
/v1/coverage
Check coverage
/v1/calculations
Create a sales tax calculation
/v1/calculations/{calculation_id}
Retrieve a calculation
/v1/transactions
Create a transaction
/v1/transactions/{transaction_id}/adjustments
Create an adjustment
/v1/calculation-batches
Create a calculation batch
/v1/coverage
Check coverage
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Sales Tax Calculator by hand means sending a bearer stca_ key, generating an Idempotency-Key for each create call, and branching on the outcome before trusting the amounts. Through Jentic you install once, import the API from the API Directory, store the key once, and your agent calls it.
Permission scoping
The API puts transaction_id and calculation_id in the URL path, so a rule can pin your agent to the adjustments of one transaction and the operations you pick. You choose the operations it may call, so record-changing ones like creating transactions or adjustments are not included unless you add them.
Credential isolation
Your Sales Tax Calculator API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'calculate sales tax' or 'record a refund adjustment', and Jentic returns the matching operation with its input schema, including required headers like Idempotency-Key.
Alternatives and complements available in the Jentic catalogue.
Specific to using Sales Tax Calculator API through Jentic.
What authentication does the Sales Tax Calculator API use?
Per its OpenAPI spec, the Sales Tax Calculator API uses bearer authentication with a server-side API key prefixed stca_, sent in the Authorization header. The spec warns never to embed the secret key in browser or mobile code. Through Jentic the key is held by your own instance and injected at call time.
Why does the Sales Tax Calculator API require an Idempotency-Key?
The create operations for calculations, transactions, adjustments, and batches take a required Idempotency-Key header. Reusing a key with the same request returns the original result, so retries never double-record, while reusing it with different content returns a conflict.
What does the outcome field mean in a calculation response?
Each calculation and line carries an outcome, with values including calculated, not_taxable, not_obligated, reverse_charge_or_self_assess, exempt, no_general_tax, review_required, and unsupported. Check it before using the returned amounts: only calculated means tax was computed for the sale.
What are the rate limits for the Sales Tax Calculator API?
The OpenAPI spec does not state numeric rate limits. Check the documentation at https://www.salestaxcalculatorapi.com for current limits, and use calculation batches for high volumes.
Is there a Sales Tax Calculator MCP server?
You don't need an MCP server to give your agent the Sales Tax Calculator API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the calculation and transaction operations it needs, found by intent.
How do I calculate sales tax through Jentic?
Search Jentic for 'calculate sales tax', load createCalculation, and execute POST /v1/calculations with currency, tax_behavior, billing_event, seller, customer, lines, and an Idempotency-Key header. To run it on your own infrastructure, install Jentic One from its GitHub repo.
Can I limit what my agent is allowed to do with the Sales Tax Calculator API?
Yes. For a quoting agent, write a rule that allows createCalculation and getCalculation only, so it can price tax on quotes but cannot finalise transactions or record adjustments that change your tax records. Each call it makes is logged.
For Agents
Calculate sales tax, VAT, or GST for a checkout or subscription charge, check the outcome, finalise it as a transaction, and record refunds or corrections as adjustments.
Use for: I need to calculate sales tax for an order shipping to Texas, Get the VAT on a subscription renewal for a German customer, Check whether a calculation came back as review_required, Finalise this calculation as a transaction
Not supported: Does not file tax returns, register you for tax, or give legal advice. Use for calculating and recording sales tax, VAT, and GST only.
The Sales Tax Calculator API calculates sales tax, VAT, and GST for a sale from its seller, customer, ship-from and ship-to addresses, and line items, returning tax, totals, and a per-line explanation. Every calculation response carries an outcome such as calculated, not_taxable, exempt, or review_required that tells you whether the amounts can be used. A saved calculation can be finalised as a transaction and later corrected with adjustments, many calculations can be submitted as a batch, and a coverage check confirms whether a country, state, tax code, and transaction type are supported. The API does not provide legal advice.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>