# TaxJar MCP > TaxJar MCP handles sales tax across all US states and jurisdictions. Use this MCP to automatically calculate, collect, and record sales tax on every order, no matter where it ships. It manages complex rules like jurisdictional nexus and verifies addresses in real time so you always stay compliant with fluctuating state laws. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** sales-tax, tax-calculation, nexus-management, compliance, tax-automation, order-management ## Description Running an e-commerce business means wrestling with a massive headache: state sales tax. Tax rates change constantly, sometimes hourly, depending on the destination ZIP code and product type. You don't have to memorize every rule for California, New York, or any other jurisdiction. This MCP connects your existing sales tax account directly to your agent. Instead of manually checking rate tables or running complex scripts, you simply ask your AI client what the tax should be for a new order. It instantly calculates the precise real-time rate and verifies that the shipping address is valid for tax purposes. Furthermore, if an order gets returned, it processes the refund automatically. All compliance tracking—from monitoring where you have physical nexus to logging every transaction—is available through natural conversation. By connecting this MCP via Vinkius, your agent handles all the heavy lifting, keeping your books accurate and preventing costly oversights. ## Tools ### calculate_sales_tax Calculates the precise sales tax amount for a given order total and location. ### create_tax_order Records a new sale transaction into your system's compliance history. ### create_tax_refund Logs a recorded refund against a previous order, managing the tax liability change. ### delete_tax_order Removes an existing sales order record from your system's transaction history. ### get_tax_account Checks the current status and general API connectivity of your tax account. ### get_tax_order Retrieves all specific details for a single, existing sales order record. ### get_tax_rates Fetches the current state and local tax rates based on a provided ZIP code. ### list_tax_categories Lists all product categories recognized by your account, helping apply correct exemptions. ### list_nexus_regions Retrieves a list of geographical regions where you currently have sales tax obligations. ### list_tax_orders Gets a summary listing of multiple past and current order transactions. ### update_tax_order Modifies existing details on an order, such as correcting tax rates or amounts after the sale. ### validate_tax_address Checks a shipping address to confirm its accuracy and determine the correct tax jurisdiction. ## Prompt Examples **Prompt:** ``` Calculate sales tax for a $150 order to NY 10001, USA. ``` **Response:** ``` I've calculated the tax. For a $150.00 order to New York (10001), the total sales tax is $13.31 (8.875%). The total amount including tax would be $163.31. Would you like to log this transaction? ``` **Prompt:** ``` Show me all regions where I have a tax nexus. ``` **Response:** ``` Retrieving nexus data... You currently have active sales tax nexus in 3 regions: California (CA), Florida (FL), and New York (NY). Shall I check the tax rates for any of these states? ``` **Prompt:** ``` Find the tax rate for ZIP code 90210. ``` **Response:** ``` The sales tax rate for Beverly Hills (90210, CA) is currently 9.5%. This includes a state rate of 6%, a county rate of 0.25%, and a local rate of 3.25%. ``` ## Capabilities ### Calculate real-time sales tax You tell the system an order total and a shipping address, and it returns the exact calculated sales tax amount. ### Verify addresses for tax jurisdiction The MCP checks if a given street address is valid and determines the correct tax rules for that specific location. ### Manage order and refund transactions It can create, update, delete, or retrieve records for sales orders and subsequent refunds to keep your ledger accurate. ### Monitor tax compliance regions You ask the MCP where your business has a 'nexus,' and it lists all required states for you to stay legally compliant. ### Lookup general sales tax rates It can retrieve standard sales tax rates just by knowing a ZIP code or city name, helping with cost estimates. ## Use Cases ### Processing a large bulk order The operations lead gets an inquiry for 50 custom units shipping to five different states. Instead of calling the tax authority, they ask their agent to run get_tax_rates and calculate_sales_tax five times, getting accurate rates for every single location in one go. ### Handling a return A customer returns an item. The accountant doesn't have to manually adjust the books; they simply prompt the agent to use create_tax_refund and provide the order ID, completing the adjustment instantly. ### Setting up a new market The e-commerce manager is expanding into Florida. They ask their agent to list_nexus_regions to confirm if they need to worry about tax there and then use validate_tax_address on target zip codes for immediate testing. ### Correcting a mistake The finance team realizes an order was recorded with the wrong rate. Instead of manually emailing support, they tell their agent to update_tax_order using the correct tax details, fixing the ledger immediately and keeping records clean. ## Benefits - Stop worrying about fluctuating rates. You can use the calculate_sales_tax tool to get real-time, precise tax amounts for any order address in minutes. - Maintain perfect audit records by using create_tax_order or create_tax_refund to log every transaction and adjustment, making reconciliation simple. - Stay ahead of legal changes. Use list_nexus_regions to know exactly where your business is required to collect tax, eliminating compliance blind spots. - Save time on logistics checks. Running validate_tax_address ensures that the address you ship to is accurate for tax purposes before any fulfillment begins. - Keep everything organized by listing all transactions with list_tax_orders and getting specific details using get_tax_order. ## How It Works The bottom line is you get immediate access to professional-grade sales tax compliance tools without writing a single line of integration code. 1. Subscribe to this MCP and provide your required TaxJar API token. 2. Your agent connects the tool using that token, making it available for any query in your AI client. 3. You simply ask your agent a question, like 'What is the tax on this order?' and receive an actionable, calculated answer. ## Frequently Asked Questions **How does TaxJar MCP help with nexus management?** It helps by listing_nexus_regions. This tool tells you exactly which states are monitoring your sales activity, ensuring you never accidentally operate in a non-compliant zone. **Can I use TaxJar MCP for refunds?** Yes, you can record tax adjustments using the create_tax_refund tool. This logs the refund correctly against the original order, keeping your books balanced. **What if I change an order after it's created?** You use the update_tax_order tool to modify existing records. It manages changes to tax rates or amounts and keeps a clean audit trail for you. **Does TaxJar MCP just calculate taxes, or can it handle orders too?** It handles both. You use the calculate_sales_tax tool for rates, but you also use create_tax_order to record the final transaction into your system. **Is validate_tax_address always necessary?** While it's best practice, especially when launching in new regions. It guarantees that the address provided is valid for tax purposes before you process anything.