[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [San Antonio building permit search](https://spiral.ai/integrations/codex/san-antonio-building-permit-search)

# How to Use San Antonio building permit search in Codex

Returns matching issued permits from San Antonio's Development Services records. Use it to build a list of projects before examining individual permits or comparing contractor activity.

|  |  |
| --- | --- |
| Model | San Antonio building permit search |
| Available through | Alexandria |
| Category | Listings |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with San Antonio building permit search in Codex

- Use San Antonio building permit search to retrieve issued commercial remodel permits in ZIP 78215 during October 2026 and add a permit table to this project's reporting page.
- Use San Antonio building permit search to retrieve solar permits issued in ZIP 78245 during 2025 and generate a monthly count table in this repository.
- Use San Antonio building permit search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from San Antonio building permit search and tell me what changed since last week.
- Check San Antonio building permit search and summarize what you find in three bullet points.

## How to set up San Antonio building permit 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 San Antonio building 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": "data-sanantonio-gov/building-permits/search_permits",
    "input": {
      "zip": "<zip>"
    }
  }'
```

Then paste one of the prompts above: Codex finds San Antonio building permit search on Spiral, shows the price and runs it.

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

## San Antonio building permit search tools and prices

- [City of San Antonio Open Data: building permits (data.sanantonio.gov) · Search permits](https://spiral.ai/tools/alexandria/data-sanantonio-gov/building-permits/search_permits) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| zip |  | — | 5-digit ZIP code (78215). Pattern: ^[0-9]{5}$. |
| sort | issued_desc, applied_desc, valuation_desc | issued_desc | issued_desc: newest issued first; applied_desc: newest submitted first; valuation_desc: largest declared valuation first. |
| limit | 1 to 100 | 25 | Permits per page. |
| cursor |  | — | next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. |
| address |  | — | Street line, case-insensitive substring (717 N Alamo St, 315 Tahoe Avenue). Text after a comma is ignored; North/South/East/West after the house number and a trailing Street, Avenue, Drive, Road, Boulevard, Lane and similar become the city's abbreviations (N, ST, AVE, DR, RD, BLVD, LN). Also matches the project name of permits published without an address. |
| contractor |  | — | Case-insensitive substring of the primary contact (Lennar, Will Fix It, Sunrun). |

## What can you do with San Antonio building permit search in Codex?

Build a San Antonio construction report that connects activity summaries to individual permit records. A coding agent can turn the city's published data into project tables and document the July 2020 history boundary.

### Compare solar permitting activity

Rank published business contacts associated with solar permits, inspect their project lists, and read selected permits in full to prepare a San Antonio solar market brief.

### Plan roofing supply coverage

Compare roofing permit activity across San Antonio ZIP codes, identify business contact groupings with substantial activity, and examine individual permits before planning supply coverage.

### Research homebuilder activity

Review Lennar's published contact groupings, assemble its issued new-home permits for a defined period, and inspect individual records for a homebuilding activity report.

### Study commercial remodeling

Find commercial remodel permits, compare the associated business contact groupings, and examine selected records to describe where permitting activity is concentrated.

### Check a public facility's permit history

Search a public facility or commercial property's address and read matching permits in full to assemble its published permit history within the available date coverage.

### Prepare a local construction brief

Build a monthly list of issued permits, summarize business contact activity, and examine selected project records to support a local reporting assignment.

## Overview

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

## San Antonio building permit search in other agents

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

## More Codex guides

- [Redfin rental search results](https://spiral.ai/integrations/codex/redfin-rental-search-results)
- [San Antonio contractor permit activity](https://spiral.ai/integrations/codex/san-antonio-contractor-permit-activity)
- [Redfin rental policies](https://spiral.ai/integrations/codex/redfin-rental-policies)
- [San Antonio permit details](https://spiral.ai/integrations/codex/san-antonio-permit-details)
- [Redfin rental listing details](https://spiral.ai/integrations/codex/redfin-rental-listing-details)
- [San Francisco building permit details](https://spiral.ai/integrations/codex/san-francisco-building-permit-details)

## Questions about San Antonio building permit search in Codex

**Can Codex use San Antonio building permit search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run San Antonio building permit search like any built-in tool.

**How much does San Antonio building permit 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 San Antonio building permit search in Codex?**

No. Spiral runs San Antonio building 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 San Antonio building permit search in Codex?**

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

**Does Codex wait while San Antonio building permit search runs?**

San Antonio building permit search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**How far back do these San Antonio permit records go?**

The documented coverage starts in July 2020 and runs through the city's latest published load. It is not a complete historical archive of construction in San Antonio.

**Where are San Antonio permits from before July 2020?**

The city's separate Legacy Permit Data Portal covers building permits issued from April 2003 through November 2020. Use that archive when researching work outside this dataset's history.

**Can this data identify recently changed permits?**

The dataset has no record-level update timestamp. It supports checks for newly issued permits by issue date, but that date does not establish when an older permit record was revised.

**Does contractor activity represent one total per construction company?**

The rankings group primary-contact names, which can identify a contractor, builder, or expediter. Interpret each result as a published contact grouping rather than a verified company-wide total.

**Does the published data include every document about a project?**

No. The publisher directs requests for additional building-activity information and documentation beyond the downloadable datasets to the city's open records process.

