[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [San Francisco building permit details](https://spiral.ai/integrations/opencode/san-francisco-building-permit-details)

# How to Use San Francisco building permit details in opencode

Returns one San Francisco building permit with its published details and associated contractors, architects, and engineers. Use it to examine a specific project's record after finding its permit number.

|  |  |
| --- | --- |
| Model | San Francisco building permit details |
| 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 Francisco building permit details in opencode

- Find the newest available permit at SFMOMA, 151 Third Street, then use San Francisco building permit details to create a project fixture from the published record.
- Use San Francisco building permit details to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from San Francisco building permit details and tell me what changed since last week.
- Check San Francisco building permit details and summarize what you find in three bullet points.
- Pull the newest data from San Francisco building permit details and give me the result as a table.

## How to set up San Francisco building permit details in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 Francisco building permit details**: 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-sf-gov/building-permits/get_permit",
    "input": {
      "permit_number": "<permit_number>"
    }
  }'
```

Then paste one of the prompts above: opencode finds San Francisco building permit details on Spiral, shows the price and runs it.

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

## San Francisco building permit details tools and prices

- [DataSF open data portal · Get permit](https://spiral.ai/tools/alexandria/data-sf-gov/building-permits/get_permit) (Alexandria): $0.00873 per call.

## What can you do with San Francisco building permit details in opencode?

Build a San Francisco construction report that connects permit records with the professional firms associated with them. A coding agent can turn the results into project tables and keep repeated addresses or contacts from inflating permit totals.

### Build a contractor shortlist

Identify firms with recorded activity for the intended work, find their permits, and examine project descriptions and associated businesses before requesting proposals.

### Write a neighborhood construction brief

Summarize permits in a San Francisco ZIP code, identify active contracting firms, and inspect notable records for the descriptions and dates behind the brief.

### Research commercial renovation examples

Find office or retail work, identify firms associated with those permits, and review individual records to assemble examples relevant to a planned renovation.

### Compare construction market activity

Combine contractor rankings with permit searches and selected record reviews to compare recorded work across San Francisco ZIP codes. Keep permit counts separate from address and contact counts.

### Research a public venue's alterations

Find permits at a museum, theater, or other public venue and examine the published scope, dates, and associated professional firms for a building research brief.

### Check a firm's recorded project experience

Use contractor activity to identify firms worth examining, search their published permit associations, and inspect selected projects for evidence of relevant work.

## Overview

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

## San Francisco building permit details in other agents

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

## More opencode guides

- [San Antonio permit details](https://spiral.ai/integrations/opencode/san-antonio-permit-details)
- [San Francisco building permit search](https://spiral.ai/integrations/opencode/san-francisco-building-permit-search)
- [San Antonio contractor permit activity](https://spiral.ai/integrations/opencode/san-antonio-contractor-permit-activity)
- [San Francisco contractor permit activity](https://spiral.ai/integrations/opencode/san-francisco-contractor-permit-activity)
- [San Antonio building permit search](https://spiral.ai/integrations/opencode/san-antonio-building-permit-search)
- [San José building permit details](https://spiral.ai/integrations/opencode/san-jos-building-permit-details)

## Questions about San Francisco building permit details in opencode

**Can opencode use San Francisco building permit details?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run San Francisco building permit details like any built-in tool.

**How much does San Francisco building permit details cost in opencode?**

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

**Do I need an Alexandria account to use San Francisco building permit details in opencode?**

No. Spiral runs San Francisco building permit details 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 Francisco building permit details in opencode?**

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

**Does opencode wait while San Francisco building permit details runs?**

San Francisco building permit details runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What area and permit records does this source cover?**

These records cover building permit applications filed with San Francisco's Department of Building Inspection. That coverage boundary is city building permits, rather than a statewide construction database.

**How fresh are the building permit records?**

DBI says it uploads the building permit dataset nightly. A permit filed or changed during the day may therefore appear after the next overnight upload.

**Can I count each published row as a separate project?**

A single permit can have several contacts or addresses, creating repeated permit applications in combined records. Count distinct permit numbers when measuring permits, and keep addresses and contacts as separate related records.

**What business contact information is public?**

The city publishes permit contact records that can contain a contact name, address, license number, and firm or company. The provider can return contractors, architects, and engineers associated with a permit.

**How should I interpret a permit's current status?**

The city's column documentation says to read current status together with the approved, issued, and completed dates. Use those dates when distinguishing application activity from issued or completed work.

