[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Miami building permit search](https://spiral.ai/integrations/codex/miami-building-permit-search)

# How to Use Miami building permit search in Codex

Finds City of Miami permit records with work descriptions, status, dates, contractor companies, and recorded costs. Use it to investigate a commercial address or assemble permits for a construction market report.

|  |  |
| --- | --- |
| Model | Miami 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 Miami building permit search in Codex

- Use Miami building permit search to retrieve permits for 2900 Biscayne Blvd, Miami, and add a table to this project's report with permit number, work description, status, issue date, and contractor company.
- Use Miami building permit search to find POWER DESIGN INC permits issued in the City of Miami during 2025 and export their permit numbers, addresses, work descriptions, and recorded costs to a CSV in this project.
- Use Miami 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 Miami building permit search and tell me what changed since last week.
- Check Miami building permit search and summarize what you find in three bullet points.

## How to set up Miami 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 Miami 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": "datahub-miamigis-opendata-arcgis-com/building-permits/search_permits",
    "input": {
      "sort": "issued_desc"
    }
  }'
```

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

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

## Miami building permit search tools and prices

- [City of Miami Open Data: building permits · Search permits](https://spiral.ai/tools/alexandria/datahub-miamigis-opendata-arcgis-com/building-permits/search_permits) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort | issued_desc, applied_desc, updated_desc, valuation_desc | issued_desc | issued_desc: newest issue date first; applied_desc: newest application first; updated_desc: most recent status change first; valuation_desc: largest total cost first. |
| limit | 1 to 100 | 25 | Records per page. |
| cursor |  | — | next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. |
| status |  | — | Case-insensitive substring over status (Active, Final, Expired, Revoked, Hold) and its reason (stop work order). |
| address |  | — | Street address or part of it, matched case-insensitively as a substring of the site address. It is converted to the City's spelling first: ordinals become numbers, street types and directions are abbreviated (Avenue to AV, Northwest to NW), and unit, city, state and ZIP are dropped, so the match covers the whole building. |
| parcel_id |  | — | Miami-Dade folio number, 13 digits with or without dashes (0141220010740 or 01-4122-001-0740). Exact match. Pattern: ^[0-9][0-9 .-]{10,15}[0-9]$. |

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

Build a Miami construction report in your project from permit records and contractor totals. Give readers a way to inspect the published permit behind each project example.

### Build a contractor shortlist

Compare companies handling Miami commercial work, review their matching permits, and inspect selected records for relevant project scope.

### Compare electrical construction activity

Rank companies associated with electrical permits, assemble their project records, and examine the work descriptions behind the totals.

### Prepare a roofing procurement brief

Identify companies with roofing permit activity, review examples at commercial properties, and inspect individual records before inviting bids.

### Research construction supplier demand

Use work descriptions and project locations to research demand for construction materials, compare active contractor companies, and inspect relevant permits.

### Publish a local construction report

Describe permit activity by period, compare contractor totals, and check the full records used as examples in the report.

### Review a commercial property's permit history

Find permits at a commercial address and examine their work descriptions, dates, contractor companies, and current published status.

### Monitor commercial project status

Revisit permits for selected commercial sites and inspect the full record when the published status or work description changes.

## Overview

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

## Miami building permit search in other agents

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

## More Codex guides

- [Miami building permit details](https://spiral.ai/integrations/codex/miami-building-permit-details)
- [Miami contractor permit activity](https://spiral.ai/integrations/codex/miami-contractor-permit-activity)
- [Los Angeles contractor certificate rankings](https://spiral.ai/integrations/codex/los-angeles-contractor-certificate-rankings)
- [Montana GIS publication status](https://spiral.ai/integrations/codex/montana-gis-publication-status)
- [Los Angeles certificate of occupancy search](https://spiral.ai/integrations/codex/los-angeles-certificate-of-occupancy-search)
- [Montana GIS record lookup](https://spiral.ai/integrations/codex/montana-gis-record-lookup)

## Questions about Miami building permit search in Codex

**Can Codex use Miami building permit search?**

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

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

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

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

**Does Codex wait while Miami building permit search runs?**

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

**Does this cover all of Miami-Dade County?**

The documented scope is permits issued by the City of Miami since 2014. It does not establish countywide coverage or a permit history before 2014.

**How fresh are the permit records?**

The data provider documents daily reloads. That supports daily reporting, but it does not promise that a city action appears immediately.

**What public information does the city publish?**

The layer includes work descriptions, permit status, contractor companies, addresses, folios, recorded costs, and square footage. It has no attachments, so the published layer does not supply attached building plans.

**Does one source response contain the entire permit history?**

The underlying ArcGIS service declares a maximum record count of 2,000. That source limit is separate from the result limit of the endpoint you use.

**Can I reuse Miami permit data in a commercial report?**

The dataset is identified as CC BY 4.0. That license permits commercial reuse with appropriate credit, a license link, and an indication of changes.

