# Tax Registrations and Business Licenses — MCP | Avalara Developer

Source: https://developer.avalara.com/products/registration-and-licensing/mcp/

## Avalara Tax Registrations and Business Licenses MCP server

## Overview

Provides access to Avalara Tax Registration and Business Licenses APIs for creating License Guidance, License Filing, Sales Tax Registration, Payroll Tax Registrations Only (PTR), and Unemployment Insurance Registration orders, as well as questionnaire management, industry regulation lookups, and filing authority data.

## How to connect to MCP server

-   Contact partner support to get your credentials (client\_id and client\_secret).
-   Generate a token by calling:
    
    curl --location 'https://identity.avalara.com/connect/token' \\
    --data-urlencode 'grant\_type=client\_credentials' \\
    --data-urlencode 'client\_id=YOUR\_CLIENT\_ID' \\
    --data-urlencode 'client\_secret=YOUR\_CLIENT\_SECRET' \\
    --data-urlencode 'resource=https://mcp.avalara.com/bl'
    
-   Once generated, paste the token into the MCP client configuration under the Authorization header.
-   Use the following JSON configuration for the MCP clients:
    
    {
      "avalara-bl": {
        "transport": "http",
        "url": "https://mcp.avalara.com/bl",
        "headers": {
          "Authorization": "Bearer access\_token\_here"
        }
      }
    }
    

## MCP client setup

### Cursor

#### Install MCP Server

Add the Avalara Tax Registrations and Business Licenses MCP server to your IDE

Or manually add to your MCP settings:

{
  "mcpServers": {
    "avalara-bl": {
      "type": "http",
      "url": "https://mcp.avalara.com/bl",
      "headers": {
        "Authorization": "Bearer access\_token\_here"
      }
    }
  }
}

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

## Tools

Name

Description

Sample prompt

get\_license\_totals\_by\_jurisdiction

Provides license totals by jurisdiction for a location and business context.

How many licenses are required for a {business\_type} in {city}, {state} with zip code {zip\_code}?

get\_location\_authorities

Returns payroll registration authority counts for a given location.

How many payroll registration authorities are required for a business at {address}?

get\_state\_regulation\_status

Determines whether a business activity is regulated in a given state.

Is a {business\_type} regulated in {state}?

get\_questionnaire\_schema

Provides question keys by question group for registration order forms to support mapping additional information to the questionnaire.

-   How do I provide the Entity Type when placing a Filing Assist Questionnaire order?
-   Get questionnaire schema for registration order forms.
-   Show question keys by question group for the questionnaire.
-   What fields are available in the questionnaire schema?

search\_industry\_keywords

Searches industry keywords by text and returns matching keywords with industry keyword ID.

Search industry keywords matching {search\_text} for license research.

create\_license\_guidance\_order

Creates an Avalara License Guidance (ALG) order to analyze a business location and activities and returns required licenses without filing them. Supports pre-populating key answers and allows one location per order.

Create a License Guidance order to determine required licenses for a {business\_type} at {address}.

create\_license\_filing\_order

Creates an Avalara License Filing (ALF) order for filing required business licenses and tax registrations on behalf of the customer. Requires a keyword and location.

Create a License Filing order for a {business\_type} at {address}.

create\_payroll\_registration\_order

Creates a Payroll Tax Registrations Only (PTR) order for one or more locations. Each location requires a full address and supports determining registration quantities.

Create a Payroll Tax Registrations Only order for a business with employees at {address\_1} and {address\_2}.

create\_sales\_tax\_order

Creates a Sales Tax Registration order to register a business to collect sales tax in one or more locations.

Create a Sales Tax Registration order for a {business\_type} in the states {state\_list}.

create\_unemployment\_registration\_order

Creates an Unemployment Insurance Registration only order for unemployment insurance registrations.

Create an Unemployment Insurance Registration order for a business at {address}.