> This page is for MCPs, version MCP servers.
> For other versions, use one of these documentation indexes:
> - Overview (default): https://avalara.ferndocs.com/mcp/overview/llms.txt
> - MCP servers: https://avalara.ferndocs.com/mcp/mcp-servers/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://avalara.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://avalara.ferndocs.com/_mcp/server.

# Classification MCP server

## 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:

```json
{
  "mcpServers": {
    "avalara-classification": {
      "type": "http",
      "url": "https://mcp.avalara.com/classification"
    }
  }
}
```

View Cursor MCP server documentation [Link](https://cursor.com/docs/mcp)

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