[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [FEMA USA Structures building records](https://spiral.ai/integrations/codex/fema-usa-structures-building-records)

# How to Use FEMA USA Structures building records in Codex

Returns pages of USA Structures records from FEMA's hosted ArcGIS view. Use it to assemble a building inventory or summarize recorded building uses across the returned counties.

|  |  |
| --- | --- |
| Model | FEMA USA Structures building records |
| 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 FEMA USA Structures building records in Codex

- Use FEMA USA Structures building records to collect education structures for Wake County, North Carolina, and add a county summary to this project's planning report.
- Use FEMA USA Structures building records to collect commercial structures for Harris County, Texas, and build an address-coverage table in this project.
- Use FEMA USA Structures building records to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from FEMA USA Structures building records and tell me what changed since last week.
- Check FEMA USA Structures building records and summarize what you find in three bullet points.

## How to set up FEMA USA Structures building records 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 FEMA USA Structures building records**: 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": "gis-fema-hub-arcgis-com/building-footprints/records_list",
    "input": {
      "fips": "<fips>"
    }
  }'
```

Then paste one of the prompts above: Codex finds FEMA USA Structures building records on Spiral, shows the price and runs it.

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

## FEMA USA Structures building records tools and prices

- [FEMA / ORNL USA Structures · Records list](https://spiral.ai/tools/alexandria/gis-fema-hub-arcgis-com/building-footprints/records_list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | next_cursor from the previous page (opaque; pins publication and segment). |
| occ_cls |  | — | Optional occupancy class filter (exact upstream value): Residential, Commercial, Industrial, Agriculture, Government, Education, Assembly, Utility and Misc, Unclassified. Pattern: ^[A-Za-z0-9 &/-]+$. |
| page_size | 1 to 2000 | 2000 | Rows per page; the view's maxRecordCount is 2000. |

## What can you do with FEMA USA Structures building records in Codex?

Build a public-facility inventory with a documented FEMA USA Structures publication behind it. A coding agent can turn returned building records or publication metadata into imports, review tables, and refresh checks in your project.

### Public-building planning inventory

Check the state publication, collect government building records, and recheck selected structures before preparing a public-facility inventory. Keep the publication context alongside the resulting counts.

### Education building review

Build a county summary of education structures, inspect selected building details, and check whether FEMA has published a newer state inventory before the next planning cycle.

### Commercial building summary

Summarize commercial structure records for a local economic-development brief. Check the source publication first, then recheck buildings selected as examples so the brief reflects their recorded attributes.

### Emergency planning baseline

Prepare a baseline of government, education, and commercial structures for comparison with a separately supplied hazard map. Check publication status and review selected building records before calculating exposure summaries.

### Inventory refresh review

Watch state publication metadata for revisions, refresh the affected building inventory, and inspect selected records behind changed totals. Use the review to explain which source publication underlies each report.

### Public-facility address coverage audit

Measure address coverage among government and education structure records. Recheck a sample of incomplete records and compare the findings after the next state publication.

## Overview

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

## FEMA USA Structures building records in other agents

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

## More Codex guides

- [FEMA USA Structures building details](https://spiral.ai/integrations/codex/fema-usa-structures-building-details)
- [FEMA USA Structures publication status](https://spiral.ai/integrations/codex/fema-usa-structures-publication-status)
- [Earth Search Sentinel-2 vegetation indices](https://spiral.ai/integrations/codex/earth-search-sentinel-2-vegetation-indices)
- [Los Angeles certificate of occupancy details](https://spiral.ai/integrations/codex/los-angeles-certificate-of-occupancy-details)
- [Earth Search Sentinel-2 scene search](https://spiral.ai/integrations/codex/earth-search-sentinel-2-scene-search)
- [Los Angeles certificate of occupancy search](https://spiral.ai/integrations/codex/los-angeles-certificate-of-occupancy-search)

## Questions about FEMA USA Structures building records in Codex

**Can Codex use FEMA USA Structures building records?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run FEMA USA Structures building records like any built-in tool.

**How much does FEMA USA Structures building records 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 FEMA USA Structures building records in Codex?**

No. Spiral runs FEMA USA Structures building records on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up FEMA USA Structures building records in Codex?**

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

**Does Codex wait while FEMA USA Structures building records runs?**

FEMA USA Structures building records runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does USA Structures include every building?**

Its stated coverage is buildings larger than 450 square feet across the United States and its territories. Small sheds and other structures below that threshold fall outside its stated scope.

**How often does USA Structures change?**

FEMA describes the inventory as updated annually. It should not be read as a daily record of construction or demolition.

**What information accompanies the building inventory?**

The current dataset description reports population attributes, building code, and county information across all states and territories. These attributes support area-level planning and exposure summaries.

**How precisely do the building outlines match imagery?**

The 2024 technical paper reports horizontal offsets of up to 5 meters in the source satellite imagery. It warns that the resulting outlines will not align with every target image.

**Why do some buildings lack street addresses?**

The technical paper says missing addresses often reflect gaps in available open address data. A building can therefore appear in the inventory without a street address.

