Avalara Returns

This is a non-community repo, created and maintained by Avalara

---

Avalara MCP Servers

MCP (Model Context Protocol) servers connect AI applications with Avalara's tax compliance systems in a standardized way. MCP servers allow partners and developers to integrate AI-driven tax workflows, automate cross-border compliance, and access Avalara's regularly updated tax content.

Avalara-supported MCP servers include AvaTax, Returns, E-Invoicing and Live Reporting, Tax Registrations and Business Licenses and Exemption Certificate Management, Cross Border Trade, and Tax Content. More services will be added over time.

What you can do:

1. Query real-time tax rates and calculations
2. Access compliance monitoring and regulatory updates
3. Manage exemption certificates, business licenses, and returns
4. Retrieve documentation and guidance

Getting Started with Avalara MCP Servers

Learn how to set up and connect to Avalara Model Context Protocol (MCP) servers for AI-powered tax compliance integration.

Prerequisites

To connect to Avalara MCP servers, you need to have:

• Avalara subscription: You must have an active Avalara account
• An AI client: Programmatic clients built using FastMCP or any other MCP-compatible library.
• A modern web browser: Required for the OAuth 2.1 authorization flow.

How to connect:

Step 1: Set up the MCP client Follow the steps provided on the individual MCP server pages.

Step 2: Authorize access

• When prompted, your MCP client redirects you to Avalara's secure sign in page
• Sign in with your Avalara credentials
• Review the permissions requested by the client for access to specific MCP server capabilities
• Grant consent to complete the OAuth flow

Available MCP Servers

Server	Description	Install
Avalara AvaTax MCP server	Provides access to the Avalara AvaTax API for tax calculation, transaction management, nexus handling, and compliance data.
Avalara Returns MCP server	Provides access to the Avalara Global Returns API for tax returns management, filing calendars, and compliance data.
Avalara Tax Registrations and Business License MCP server	Provides access to Avalara Tax Registration and Business Licenses APIs for license guidance, sales and payroll tax registrations, questionnaire management, and business activity validation.
Avalara E-Invoicing & Live Reporting MCP server	Provides access to Avalara E-Invoicing and Live Reporting APIs for retrieving document statuses, downloading compliant documents, and managing compliance across jurisdictions.
Avalara Exemption Certificates Management MCP server	Provides access to the Avalara Exemption Certificate Management API for managing certificates, customer profiles, and company data.
Avalara Cross-Border Trade Services MCP server	The Cross-Border Trade Services MCP server supports AI agents by providing tools to perform cross-border transactions, including duty calculations, and access to Trade and Tariff content libraries (including import trade restrictions).
Avalara Tax Content MCP server	Provides access to Avalara Tax Content (ATC) data, including Transaction Tax Export (TTE) Configurations, Jobs, Communications and User Defined Functions for Lodging and Autorental.
Avalara Communications MCP server	Provides access to Avalara Communications tax calculation services, supporting taxes for voice, data, VoIP, and messaging transactions. It also provides reference data including tax types, jurisdiction codes, and location information.
Avalara Dev Documentation MCP server	Provides access to Avalara developer documentation and integration guides, including technical documentation, product information, how-to guides, and code examples.
Avalara Classification MCP server	Provides Harmonized System (HS) code classification for cross-border transactions. Supports managed classification requests, HS code validation and verification, and AI-powered import and export, and enriched trade compliance content lookup.

Troubleshooting common issues:

• Connection failed: Verify your Avalara account status and internet connection.
• Permission denied: Make ensure your account has access to the requested services.
• HTTP 429 (Too Many Requests): You've exceeded the server's rate limit.
• Wait a few minutes before retrying.
• Check the server's rate limit details on its individual page.