[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Texas Comptroller franchise entity search](https://spiral.ai/integrations/codex/texas-comptroller-franchise-entity-search)

# How to Use Texas Comptroller franchise entity search in Codex

Finds matching entities in the Comptroller’s franchise tax records. Use it to identify the legal business before retrieving its detailed franchise account.

|  |  |
| --- | --- |
| Model | Texas Comptroller franchise entity 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 franchise entity search in Codex

- Use Texas Comptroller franchise entity search to find matches for Buc-ee’s. Compare the returned legal entities with this project’s vendor records and show ambiguous matches for review.
- Use Texas Comptroller franchise entity 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 franchise entity search and tell me what changed since last week.
- Check Texas Comptroller franchise entity search and summarize what you find in three bullet points.
- Pull the newest data from Texas Comptroller franchise entity search and give me the result as a table.

## How to set up Texas Comptroller franchise entity search in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

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

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 franchise entity 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_franchise_entities",
    "input": {
      "name": "<name>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Texas Comptroller franchise entity search on Spiral, shows the price and runs it.

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

## Texas Comptroller franchise entity search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| name |  | — | Entity name fragment, 2 to 50 characters (the site refuses `<` and `>`). Matches names that start with or contain the text; a very common word (e.g. `Texas`) is refused by the site as too broad and this function returns invalid_input with the site's match count. Pattern: ^[^<>]{2,50}$. |
| sos_file_number |  | — | Texas Secretary of State file number, 6 to 10 digits (the site left-pads to 10). Pattern: ^[0-9]{6,10}$. |

## What can you do with Texas Comptroller franchise entity search in Codex?

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.

### Check a named business’s franchise record

Find the legal entity behind a business name and retrieve its franchise account for a counterparty review, including its recorded right to transact business and registration information.

## Overview

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

## Texas Comptroller franchise entity search in other agents

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

## More Codex guides

- [Sumble technology search](https://spiral.ai/integrations/codex/sumble-technology-search)
- [Texas Comptroller franchise tax account](https://spiral.ai/integrations/codex/texas-comptroller-franchise-tax-account)
- [Sumble technology lookup](https://spiral.ai/integrations/codex/sumble-technology-lookup)
- [Texas Comptroller sales tax location search](https://spiral.ai/integrations/codex/texas-comptroller-sales-tax-location-search)
- [Sumble technology categories](https://spiral.ai/integrations/codex/sumble-technology-categories)
- [Texas Comptroller sales tax outlets](https://spiral.ai/integrations/codex/texas-comptroller-sales-tax-outlets)

## Questions about Texas Comptroller franchise entity search in Codex

**Can Codex use Texas Comptroller franchise entity search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Texas Comptroller franchise entity search like any built-in tool.

**How much does Texas Comptroller franchise entity search cost in Codex?**

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

**Do I need an Alexandria account to use Texas Comptroller franchise entity search in Codex?**

No. Spiral runs Texas Comptroller franchise entity 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 franchise entity search in Codex?**

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

**Does Codex wait while Texas Comptroller franchise entity search runs?**

Texas Comptroller franchise entity search runs in the background. Codex 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.

