[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Texas Comptroller sales tax permit search](https://spiral.ai/integrations/opencode/texas-comptroller-sales-tax-permit-search)

# How to Use Texas Comptroller sales tax permit search in opencode

Finds matching sales tax taxpayers and returns business identification, address, and permit status information. Use it to find a permit holder by legal business name before checking its taxpayer record or outlets.

|  |  |
| --- | --- |
| Model | Texas Comptroller sales tax permit search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Texas Comptroller sales tax permit search in opencode

- Use Texas Comptroller sales tax permit search to find Whataburger Restaurants LLC. Compare the returned taxpayer records with our supplier table and propose matches without overwriting existing entries.
- Use Texas Comptroller sales tax permit search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Texas Comptroller sales tax permit search and tell me what changed since last week.
- Check Texas Comptroller sales tax permit search and summarize what you find in three bullet points.
- Pull the newest data from Texas Comptroller sales tax permit search and give me the result as a table.

## How to set up Texas Comptroller sales tax permit search in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Texas Comptroller sales tax permit search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "comptroller-texas-gov/entities/search_sales_tax_permits",
    "input": {
      "search_type": "legal_name"
    }
  }'
```

Then paste one of the prompts above: opencode finds Texas Comptroller sales tax permit search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Texas Comptroller sales tax permit search tools and prices

- [Texas Comptroller franchise tax account status and sales tax permits · Search sales tax permits](https://spiral.ai/tools/alexandria/comptroller-texas-gov/entities/search_sales_tax_permits) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 100000 | 1 | 1-based page; the next page number is also returned as the continuation cursor. |
| status | ACTIVE, INACTIVE | — | Permit status filter; omit for both. |
| sort_by | taxpayer_id, fei_number, business_name, individual_name, last_name, street, city, state, zip, status | — | Sort column (the site's default is taxpayer_id). |
| last_name |  | — | last_name |
| page_size | 1 to 100 | 25 | Rows per page, at most 100 (the site's cap). |
| first_name |  | — | first_name |

## What can you do with Texas Comptroller sales tax permit search in opencode?

Add Texas business verification to a vendor review screen using Comptroller entity, permit, and outlet records. A coding agent can match those records to project data and show franchise status separately from sales tax permit status.

### Check a supplier before onboarding

Find the supplier’s legal business record, review its franchise status, and verify its sales tax permit holder record before adding it to a purchasing system.

### Review a prospective retail tenant

Start with the storefront name or proposed location, identify the recorded taxpayer, and compare its permit holder, outlet, and franchise records with the legal entity named in the lease application.

### Reconcile company and storefront records

Compare legal business names, taxpayer records, and permitted outlets with existing CRM entries. Review franchise accounts to resolve company matches and keep separate outlets from becoming duplicate company records.

### Prepare a retail acquisition brief

Identify the target’s legal entity, review its franchise account, and reconcile the seller’s outlet list against sales tax location and permit holder records. Flag differences for the transaction team to investigate.

### Refresh an existing vendor review

Recheck the legal entity, franchise account, sales tax permit holder, and recorded outlets for vendors already in a purchasing system. Compare the returned records with the previous review and flag status or address changes.

### Investigate a resale customer’s permit

Find the business’s permit holder and check the associated outlet records when a legal name or store address needs clarification during a resale-certificate review.

### Reconcile a chain’s permitted outlets

Use store-name searches to find matching outlets, resolve their permit holders, and retrieve each taxpayer’s outlet list. Compare location numbers, addresses, dates, and statuses with the chain’s published store list.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Texas Comptroller sales tax permit search in other agents

- [Amp](https://spiral.ai/integrations/amp/texas-comptroller-sales-tax-permit-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/texas-comptroller-sales-tax-permit-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/texas-comptroller-sales-tax-permit-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/texas-comptroller-sales-tax-permit-search)
- [Cline](https://spiral.ai/integrations/cline/texas-comptroller-sales-tax-permit-search)
- [Codex](https://spiral.ai/integrations/codex/texas-comptroller-sales-tax-permit-search)
- [Cursor](https://spiral.ai/integrations/cursor/texas-comptroller-sales-tax-permit-search)
- [Devin](https://spiral.ai/integrations/devin/texas-comptroller-sales-tax-permit-search)
- [dots](https://spiral.ai/integrations/dots/texas-comptroller-sales-tax-permit-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/texas-comptroller-sales-tax-permit-search)
- [Gemini](https://spiral.ai/integrations/gemini/texas-comptroller-sales-tax-permit-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/texas-comptroller-sales-tax-permit-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/texas-comptroller-sales-tax-permit-search)
- [goose](https://spiral.ai/integrations/goose/texas-comptroller-sales-tax-permit-search)
- [Grok](https://spiral.ai/integrations/grok/texas-comptroller-sales-tax-permit-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/texas-comptroller-sales-tax-permit-search)
- [Hermes](https://spiral.ai/integrations/hermes/texas-comptroller-sales-tax-permit-search)
- [Instinct](https://spiral.ai/integrations/instinct/texas-comptroller-sales-tax-permit-search)
- [Manus](https://spiral.ai/integrations/manus/texas-comptroller-sales-tax-permit-search)
- [Muse](https://spiral.ai/integrations/muse/texas-comptroller-sales-tax-permit-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/texas-comptroller-sales-tax-permit-search)
- [n8n](https://spiral.ai/integrations/n8n/texas-comptroller-sales-tax-permit-search)
- [Notion](https://spiral.ai/integrations/notion/texas-comptroller-sales-tax-permit-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/texas-comptroller-sales-tax-permit-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/texas-comptroller-sales-tax-permit-search)
- [Raycast](https://spiral.ai/integrations/raycast/texas-comptroller-sales-tax-permit-search)
- [VS Code](https://spiral.ai/integrations/vscode/texas-comptroller-sales-tax-permit-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/texas-comptroller-sales-tax-permit-search)
- [Zapier](https://spiral.ai/integrations/zapier/texas-comptroller-sales-tax-permit-search)

## More opencode guides

- [Texas Comptroller sales tax permit holder](https://spiral.ai/integrations/opencode/texas-comptroller-sales-tax-permit-holder)
- [Texas SmartBuy agency directory](https://spiral.ai/integrations/opencode/texas-smartbuy-agency-directory)
- [Texas Comptroller sales tax outlets](https://spiral.ai/integrations/opencode/texas-comptroller-sales-tax-outlets)
- [Texas SmartBuy award details](https://spiral.ai/integrations/opencode/texas-smartbuy-award-details)
- [Texas Comptroller sales tax location search](https://spiral.ai/integrations/opencode/texas-comptroller-sales-tax-location-search)
- [Texas SmartBuy award search](https://spiral.ai/integrations/opencode/texas-smartbuy-award-search)

## Questions about Texas Comptroller sales tax permit search in opencode

**Can opencode use Texas Comptroller sales tax permit search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Texas Comptroller sales tax permit search like any built-in tool.

**How much does Texas Comptroller sales tax permit search cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use Texas Comptroller sales tax permit search in opencode?**

No. Spiral runs Texas Comptroller sales tax permit search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Texas Comptroller sales tax permit search in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while Texas Comptroller sales tax permit search runs?**

Texas Comptroller sales tax permit search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Are franchise status and sales tax permit status the same?**

No. Franchise status describes an entity’s right to transact business in Texas, while sales tax records classify permits as active or inactive. Check each status separately when reviewing a business.

**Can a ZIP-code search provide a complete local business list?**

The Comptroller explicitly says its sales tax search is not designed to provide complete permit-holder lists for ZIP codes or cities. Use the results to investigate matching outlets, not to count every business in an area.

**How fresh are the business records?**

Franchise status results reflect the Comptroller’s records when queried. Officer and director information follows the most recent Public Information Reports processed by the Secretary of State and updates as changes reach the Comptroller.

**Why can several outlets share one taxpayer number?**

Texas issues separate permits for multiple active business locations under the same taxpayer identification number. Separate outlet numbers distinguish those locations.

**Does a permit stay with a store after an ownership change?**

A Texas sales tax permit cannot transfer from one owner to another. When investigating a store that changed hands, check the current permit holder rather than relying on the previous operator’s record.

