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

# How to Use Miami contractor permit activity in Codex

Ranks contractor companies by issued permit count and total recorded cost for a date window. Use it to compare construction activity across companies before examining individual permits.

|  |  |
| --- | --- |
| Model | Miami contractor permit activity |
| 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 contractor permit activity in Codex

- Use Miami contractor permit activity to compare companies with electrical permits issued in the City of Miami during 2025, then add the counts and recorded cost totals to this project's market report.
- Use Miami contractor permit activity to compare roofing contractor activity in the City of Miami for 2024 and 2025, then add a year-by-year comparison to this project's report.
- Use Miami contractor permit activity to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Miami contractor permit activity and tell me what changed since last week.
- Check Miami contractor permit activity and summarize what you find in three bullet points.

## How to set up Miami contractor permit activity 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 contractor permit activity**: 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/contractor_activity",
    "input": {
      "issued_since": "<issued_since>"
    }
  }'
```

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

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

## Miami contractor permit activity tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 25 | Contractors per page. |
| cursor |  | — | next_cursor from the previous page. Pattern: ^[0-9]+$. |
| permit_type |  | — | Only permits whose scope of work, property type or work items contain these words (roof, electrical, new construction, residential). |
| issued_until |  | — | Last issue day, inclusive (YYYY-MM-DD); open-ended when omitted. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |

## What can you do with Miami contractor permit activity 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.

## Overview

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

## Miami contractor permit activity in other agents

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

## More Codex guides

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

## Questions about Miami contractor permit activity in Codex

**Can Codex use Miami contractor permit activity?**

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

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

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

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

**Does Codex wait while Miami contractor permit activity runs?**

Miami contractor permit activity 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.

