# TaxJar MCP > TaxJar MCP gives your agent precise commercial tax intelligence for e-commerce operations. Calculate sales tax liability across state lines, validate if a customer's address is valid for tax purposes, and check your company's active nexus regions instantly from the terminal. Stop manually checking complex checkout rules; get real-time tax compliance data directly into your workflow. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** sales-tax, tax-compliance, nexus-verification, tax-calculation, ecommerce-automation, financial-reporting ## Description Calculating sales tax used to mean opening separate dashboards, cross-referencing ZIP codes against state laws, and praying you didn’t miss a localized rate. Now, your agent handles it all. This MCP gives your AI client the power of a regulatory accountant, letting it instantly calculate complex tax liabilities for any given order. Need to know if you have an obligation to collect sales tax in Oregon? Or maybe you're checking out a high-value item and need the precise rate for that county? Your agent runs the checks and gives you the definitive number. When you connect this MCP through Vinkius, your AI client pulls structured tax data—from validating addresses to listing customer exemptions—and presents it directly in your secure terminal workspace. It eliminates dashboard navigation and turns complex compliance into a simple query. ## Tools ### calculate_sales_tax Inputs order details, including addresses and amounts, to calculate the precise sales tax owed for that specific transaction. ### get_tax_order_details Retrieves a full set of financial details for any previously completed or recorded order transaction. ### get_tax_rates Fetches the specific sales tax rate applicable to an order based on a provided ZIP code. ### get_summary_tax_rates Retrieves broad minimum and average tax rates across entire regions for comparative analysis. ### get_tax_categories Lists all available product tax categories used by TaxJar, allowing you to classify goods correctly. ### list_tax_customers Generates a list of customer records and checks for any specific documented sales tax exemptions. ### list_nexus_regions Provides a comprehensive list of all states or regions where the business currently holds tax nexus. ### list_tax_orders Lists previously recorded order transactions, giving you an overview of your sales history for auditing. ### list_tax_refunds Generates a list detailing all past refund transactions and their associated tax adjustments. ### validate_tax_address Accepts address details to confirm if the location is physically valid for the purpose of calculating sales tax. ## Prompt Examples **Prompt:** ``` Calculate the effective sales tax rate for ZIP code 94107. Then let me know our registered active nexus regions and if we require collection there. ``` **Response:** ``` Interrogating local thresholds ('get_tax_rates')... The estimated sales tax rate for 94107 (San Francisco, CA) is 8.625%. Checking our configured legal scopes via 'list_nexus_regions'... Active Nexus registered states: CA, TX, NY. Since California is registered, tax must be actively collected for this transaction. ``` **Prompt:** ``` Calculate the sales tax for a $50 apparel order shipping to New York City (Zip 10001). ``` **Response:** ``` Querying TaxJar rates ('calculate_tax')... Based on the product category 'apparel' and destination Zip 10001 (NY): The total tax liability is $4.44 (8.875% combined state, county, and city rate). The total order amount is $54.44. ``` **Prompt:** ``` Check if our company has nexus in California. ``` **Response:** ``` Interrogating nexus compliance ('nexus_regions')... Yes, your account reflects an active economic nexus in California (CA). Your threshold was crossed on Jan 14th, meaning you must collect and remit sales tax for transactions in CA. ``` ## Capabilities ### Calculate Order Tax Liability Determines the exact sales tax amount for an order by processing the product details, shipping address, and total cost. ### Verify Nexus Compliance Checks if your business has established a physical or economic presence (nexus) in specific states, determining where you must collect tax. ### Validate Tax Addresses Confirms that an address is valid for tax purposes, preventing incorrect calculations based on bad input data. ### Retrieve Rate Schedules Fetches specific sales tax rates either by ZIP code or provides minimum and average rate ranges across a whole region. ### Audit Customer Exemptions Lists customer records and checks if the buyer has any documented exemptions that might lower their tax bill. ## Use Cases ### Handling Cross-State Shipments A user is launching a new regional campaign. They instruct their agent to run the `calculate_sales_tax` tool for three different addresses in three different states, confirming that the tax calculation correctly adjusts based on product category and destination zip code. ### Auditing Tax Obligations A compliance analyst needs to know if they are legally required to charge sales tax in a new state. They ask their agent to run `list_nexus_regions`, immediately confirming or denying the obligation, rather than spending days reading legal documentation. ### Debugging Checkout Failures A backend engineer notices intermittent payment failures due to tax errors. They use `validate_tax_address` on the failing payload data to confirm if the issue is bad address input, allowing them to fix the source code. ### Reconciling Refunds A finance operator must reconcile a large batch of returns. They ask their agent to run `list_tax_refunds`, which instantly pulls all relevant refund transactions and associated tax adjustments for review. ## Benefits - Stop manual rate lookups. Use `get_tax_rates` to instantly find the exact sales tax percentage for any ZIP code, eliminating guesswork at checkout. - Ensure compliance by using `list_nexus_regions`. You can programmatically verify if your company has an active legal obligation (nexus) in a target state before accepting orders there. - Prevent bad data from costing you money. Use `validate_tax_address` to pre-qualify physical coordinates, making sure every calculated tax amount is based on real, usable location data. - Keep your books clean by using `list_tax_orders` and `list_tax_refunds`. You get a clear audit trail of all past transactions and adjustments without navigating multiple internal dashboards. - Process complex orders accurately. Use `calculate_sales_tax` to determine the total tax liability, combining product categories and destination addresses in one single API call. ## How It Works The bottom line is that you get verifiable, real-time tax numbers without ever leaving your development terminal. 1. First, you connect your preferred AI client to this MCP through Vinkius. You'll need a dedicated API token from TaxJar for authentication. 2. Next, you instruct your agent with the specific commercial task: 'Calculate tax on $X order shipping to Y address.' 3. Your agent runs the necessary tools and returns structured data showing the exact tax amount, applicable rates, and compliance status. ## Frequently Asked Questions **How do I use TaxJar MCP to check my business's nexus?** You run the `list_nexus_regions` tool. This tells you exactly which states your company has an active economic presence in, defining where you must collect and remit sales tax. **Can TaxJar MCP calculate tax for a custom product?** Yes. You first use `get_tax_categories` to find the correct classification for your product, then pass that category along with the order details when calling `calculate_sales_tax`. **What if I need to verify a customer's exemption status?** Use the `list_tax_customers` tool. It pulls the customer record and flags any documented exemptions that would change the final tax calculation. **How do I look up old order taxes using TaxJar MCP?** First, use `list_tax_orders` to get a list of transaction IDs. Then, use the ID with `get_tax_order_details` to pull all historical tax data for that specific sale. **Is TaxJar MCP only for US sales tax?** The tool is designed around U.S. state and local regulations, providing comprehensive coverage of US commerce laws.