MCP Server

The Ziptax MCP Server gives AI agents and LLM-powered applications direct access to real-time U.S. and Canadian sales tax data. MCP is an open standard that lets AI applications securely connect to external tools and data sources. Once connected, your agent can:

• Look up sales and use tax rates by postal code, street address, or geographic coordinates.
• Retrieve jurisdiction-level tax breakdowns (state, county, city, and district).
• Query account usage metrics and quota information.

Connection details

Authentication

Every request must include a valid API key. Two methods are supported.

Header (recommended)

1
X-API-KEY: your-api-key

Query parameter

1
https://mcp.zip-tax.com/?key=your-api-key

Tools

The server exposes two tools.

lookup_tax_rate

Look up sales and use tax rates for a U.S. or Canadian location. Provide a postal code at minimum, or a full street address for door-level precision. Returns tax rates broken down by jurisdiction (state, county, city, district).

Parameters

Provide either address for a door-level lookup, or lat and lng for a geographic point lookup.

Example response

The tool response mirrors the Ziptax REST API by Address response:

1
{
2
  "metadata": {
3
    "version": "v60",
4
    "response": {
5
      "code": 100,
6
      "name": "RESPONSE_CODE_SUCCESS",
7
      "message": "Successful API Request.",
8
      "definition": "http://api.zip-tax.com/request/v60/schema"
9
    }
10
  },
11
  "baseRates": [
12
    {
13
      "rate": 0.0725,
14
      "jurType": "US_STATE_SALES_TAX",
15
      "jurName": "CA",
16
      "jurDescription": "US State Sales Tax",
17
      "jurTaxCode": "06"
18
    },
19
    {
20
      "rate": 0.005,
21
      "jurType": "US_COUNTY_SALES_TAX",
22
      "jurName": "ORANGE",
23
      "jurDescription": "US County Sales Tax",
24
      "jurTaxCode": "30"
25
    }
26
  ],
27
  "taxSummaries": [
28
    {
29
      "rate": 0.0775,
30
      "taxType": "SALES_TAX",
31
      "summaryName": "Total Base Sales Tax",
32
      "displayRates": [
33
        { "name": "Total Rate", "rate": 0.0775 }
34
      ]
35
    }
36
  ],
37
  "addressDetail": {
38
    "normalizedAddress": "200 Spectrum Center Dr, Irvine, CA 92618-5003, United States",
39
    "incorporated": "true",
40
    "geoLat": 33.65253,
41
    "geoLng": -117.74794
42
  }
43
}

get_account_metrics

Retrieve account usage metrics and quota information for your Ziptax account. Returns current request counts, limits, and entitlements. Takes no parameters.

Client configuration

Below are configuration examples for connecting popular MCP clients to the Ziptax MCP Server. Replace your_api_key with your Ziptax API key from platform.zip.tax.

Claude Desktop

Add this block to your claude_desktop_config.json:

1
{
2
  "mcpServers": {
3
    "ziptax": {
4
      "type": "http",
5
      "url": "https://mcp.zip-tax.com/",
6
      "headers": {
7
        "X-API-KEY": "your_api_key"
8
      }
9
    }
10
  }
11
}

Cursor

Navigate to Settings → MCP and add a new server with:

• Name: Ziptax MCP Server
• Type: HTTP
• URL: https://mcp.zip-tax.com/
• Headers: X-API-KEY: your_api_key

Devin

In Devin, add the Ziptax MCP integration from the MCP Marketplace, or configure it manually under Settings → MCP Marketplace → Add Your Own:

1
{
2
  "mcpServers": {
3
    "ziptax-sales-tax-api": {
4
      "transport": "shttp",
5
      "url": "https://mcp.zip-tax.com/",
6
      "headers": {
7
        "X-API-KEY": "$ZIPTAX_API_KEY"
8
      }
9
    }
10
  }
11
}

Store your API key as a secret named ZIPTAX_API_KEY in Devin’s Secrets Manager.

Generic MCP client

Any MCP client that supports Streamable HTTP transport can connect:

• Name: Ziptax MCP Server
• Type: HTTP
• URL: https://mcp.zip-tax.com/
• Headers: X-API-KEY: your_api_key

Error handling

When a request fails, the MCP Server returns an error message in the tool result. For the full list of API response codes, see the Response Codes reference.