How do I install the Ziptax Sales Tax skill?

Run npx skillmds add modbender/ziptax-sales-tax in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ziptax Sales Tax safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ziptax Sales Tax?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ziptax Sales Tax free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ziptax Sales Tax?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ziptax Sales Tax by modbender — Agent Skill

Name: Ziptax Sales Tax
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Ziptax Sales Tax

Look up U.S. sales tax rates using the ZipTax API. Use when the user asks about sales tax rates, tax calculations for a U.S. address/ZIP code/coordinates, freight or service taxability, jurisdiction-level tax breakdowns, use tax vs sales tax, or needs to integrate sales tax data into an application. Also handles account usage metrics and product taxability codes (TIC). Supports address-level (door-level), lat/lng, and postal code lookups across 12,000+ jurisdictions.

modbender e8eafba 3 files · 9.7 KB Updated Sep 9, 2026 12 repo stars

File contents

ZipTax Sales Tax Lookup

Setup

Set ZIPTAX_API_KEY env variable with your API key from https://platform.zip.tax (DEVELOP > API Keys). Free tier gives 100 calls/month. Never share your API key publicly.

Quick Start

Address Lookup (most accurate)

curl -s "https://api.zip-tax.com/request/v60?address=200+Spectrum+Center+Drive+Irvine+CA+92618" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Postal Code Lookup

curl -s "https://api.zip-tax.com/request/v60?postalcode=92618" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Lat/Lng Lookup

curl -s "https://api.zip-tax.com/request/v60?lat=33.6525&lng=-117.7479" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Workflow

Determine lookup type: address (best), lat/lng, or postal code
Use v60 (latest) for full jurisdiction breakdowns; use v10 for simple combined rate
Make GET request to https://api.zip-tax.com/request/v60 with auth header
Check metadata.response.code — 100 means success
Read taxSummaries[0].rate for total sales tax rate
Read baseRates array for state/county/city/district breakdown
Check service.taxable and shipping.taxable for service/freight taxability

Key Points

Address > Postal code: Address gives one exact result; postal code returns all rates in that ZIP
Auth: Header X-API-KEY or query param key
Rate format: Decimal (0.0775 = 7.75%)
Response code 100 = success; check metadata.response.code
Metrics endpoint (/account/metrics) does not count against quota

Bundled Resources

scripts/lookup.sh — CLI wrapper for quick lookups. Run with --address, --lat/--lng, --postalcode, or --metrics
references/api-reference.md — Full API reference with all endpoints, response schemas, code samples, response codes, and SDK links. Read when you need endpoint details or response field definitions.

---name: ziptax-sales-taxdescription: Look up U.S. sales tax rates using the ZipTax API. Use when the user asks about sales tax rates, tax calculations for a U.S. address/ZIP code/coordinates, freight or service taxability, jurisdiction-level tax breakdowns, use tax vs sales tax, or needs to integrate sales tax data into an application. Also handles account usage metrics and product taxability codes (TIC). Supports address-level (door-level), lat/lng, and postal code lookups across 12,000+ jurisdictions.--- # ZipTax Sales Tax Lookup ## Setup Set `ZIPTAX_API_KEY` env variable with your API key from https://platform.zip.tax (DEVELOP > API Keys). Free tier gives 100 calls/month. **Never share your API key publicly.** ## Quick Start ### Address Lookup (most accurate) ```bash curl -s "https://api.zip-tax.com/request/v60?address=200+Spectrum+Center+Drive+Irvine+CA+92618" \ -H "X-API-KEY: $ZIPTAX_API_KEY" ``` ### Postal Code Lookup ```bash curl -s "https://api.zip-tax.com/request/v60?postalcode=92618" \ -H "X-API-KEY: $ZIPTAX_API_KEY" ``` ### Lat/Lng Lookup ```bash curl -s "https://api.zip-tax.com/request/v60?lat=33.6525&lng=-117.7479" \ -H "X-API-KEY: $ZIPTAX_API_KEY" ``` ## Workflow 1. Determine lookup type: address (best), lat/lng, or postal code 2. Use **v60** (latest) for full jurisdiction breakdowns; use v10 for simple combined rate 3. Make GET request to `https://api.zip-tax.com/request/v60` with auth header 4. Check `metadata.response.code` — 100 means success 5. Read `taxSummaries[0].rate` for total sales tax rate 6. Read `baseRates` array for state/county/city/district breakdown 7. Check `service.taxable` and `shipping.taxable` for service/freight taxability ## Key Points - **Address > Postal code**: Address gives one exact result; postal code returns all rates in that ZIP - **Auth**: Header `X-API-KEY` or query param `key` - **Rate format**: Decimal (0.0775 = 7.75%) - **Response code 100** = success; check `metadata.response.code` - **Metrics endpoint** (`/account/metrics`) does not count against quota ## Bundled Resources - **`scripts/lookup.sh`** — CLI wrapper for quick lookups. Run with `--address`, `--lat`/`--lng`, `--postalcode`, or `--metrics` - **`references/api-reference.md`** — Full API reference with all endpoints, response schemas, code samples, response codes, and SDK links. Read when you need endpoint details or response field definitions.

Frequently asked questions