Skip to navigation
MCP servers

Classification MCP server

View as Markdown

Avalara Classification MCP Server

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

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

Name

Description

Sample prompt

get_instant_hs_code

Classify 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_codes

Validate 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_code

Assess 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_date

Provides 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.