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

# AvaTax MCP server

## Overview

Provides access to the Avalara AvaTax API for tax calculation, transaction management, nexus handling, and compliance data.

## MCP client setup

### Cursor

#### Install MCP Server

Add the Avalara AvaTax MCP server to your IDE

Or manually add to your MCP settings:

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

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

## Tools

Name

Description

Sample prompt

calculate_tax

Creates a tax transaction and calculates tax based on provided data, including addresses, line items, and transaction details.

Calculate tax for a \$100 sale to a customer in California with shipping address 123 Main St, Los Angeles, CA 90210.

get_transaction

Retrieves details of a specific transaction by transaction code and company code.

Get transaction details for transaction code \{transaction_code} for company \{company_code}.

get_transactions

Retrieves a list of transactions for a specific company, using filters to search.

Show me all transactions for company \{company_code} from last month.

get_nexus_definitions

Retrieves nexus definitions so you can determine tax obligations across jurisdictions.

What are the nexus requirements for sales tax in Texas?

get_nexus

Retrieves company-specific nexus information and related tax registration details.

Show me all tax registrations for my company.

create_nexus

Creates nexus records to establish tax obligations in jurisdictions.

Register company \{company_code} for state-level sales tax in New York.

get_companies

Retrieves company information, with filters to narrow results to specific companies.

Show me details for all companies in my AvaTax account.

get_tax_code_definitions

Retrieves tax code definitions for available tax categories and rates.

What tax codes are available for software products?

get_tax_code_recommendations

Provides AI-powered tax code recommendations for products. Returns 1 to 3 ranked tax code suggestions with confidence levels based on product description and optional inputs such as category, itemType, or UPC.

Recommend tax codes for a steel mug sold as kitchen drinkware.

validate_address

Validates and resolves addresses to ensure accurate tax jurisdiction determination.

Validate this address: 123 Main Street, Anytown, CA 90210.