MCP servers

Avalara Classification MCP Server

View as markdown

Overview

The Classification Services MCP server supports AI agents by providing tools to perform HS code classification for cross-border transactions, including validation and verification, AI-powered import classification, and access to Trade and Tariff content libraries (including import restrictions compliance content).

MCP client setup

Cursor

Install MCP Server

Add the Avalara Classification MCP Server to your IDE

Add to Cursor

Or manually add to your MCP settings:

{
  "mcpServers": {
    "avalara-classification": {
      "type": "http",
      "url": "https://mcp.avalara.com/classification"
    }
  }
}
View Cursor MCP server documentation Link

Tools

NameDescriptionSample prompt
get_instant_hs_codeClassify your product based on its description and get recommended HS codes for the selected destination country, along with confidence scores for each result.
  • Classify this product: itemCode {item_code}, itemGroup '{item_group}', description: men's cotton polo shirt, countryOfDestination [{country_1}, {country_2}].
  • Get HS codes for item {item_code} in group '{item_group}': ceramic coffee mug, countryOfDestination [{country}].
  • Classify: rechargeable lithium battery pack, 10000mAh, item {item_code}, itemGroup '{item_group}', countryOfDestination [{country}].
validate_hs_codesValidate whether one or more HS codes are valid for import in selected countries, returning clear results with supporting details such as validation messages and effective date ranges.
  • Is HS code {hs_code} valid for {country}?
  • Validate these HS codes: {hs_code_1} in {country_1} and {hs_code_2} in {country_2}.
  • Check if HS code {hs_code} is valid for {country} (import).
verify_hs_codeAssess whether a proposed HS code aligns with a product description and destination country, returning a clear verified or not verified result.
  • Is HS code {hs_code} correct for the product: men's cotton t-shirt, countryOfDestination {destination_country}?
  • Verify {hs_code} is correct for {description} to countryOfDestination {destination_country} (laptop computer example).
  • Check if HS code {hs_code} is appropriate for {description} to countryOfDestination {destination_country} (leather handbag).
get_trade_tariff_content_library_by_dateProvides comprehensive duty rates and compliance information from the Avalara Trade and Tariff Library. Supports retrieving tariff data for specified HS codes within requested date ranges.
  • Get tariff information for HS code {hs_code}, countryOfExport {country_of_export} to countryOfImport {country_of_import}, startDate {start_date}, endDate {end_date}.
  • Find punitive duty rates for electronics, HS {hs_code}, from {country_of_export} to {country_of_import}, between {start_date} and {end_date}.
  • Show PGA and regulatory content for HS {hs_code} from {country_of_export} to {country_of_import} between {start_date} and {end_date} for textiles.