[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [DC building permit details](https://spiral.ai/integrations/opencode/dc-building-permit-details)

# How to Use DC building permit details in opencode

Returns one DC permit's published record, including its address, status, issue date, and work description. Use it to inspect a known permit or check the details behind a search result.

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

- Use DC building permit details to inspect the permit already selected for 50 Massachusetts Avenue NE, Washington, DC, and add its published status and work description to the site's project page.
- Use DC building permit details to inspect the permit selected for 801 Mount Vernon Place NW, Washington, DC, and show its issue date, address, status, and work description in the existing detail view.
- Use DC 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 DC building permit details and tell me what changed since last week.
- Check DC building permit details and summarize what you find in three bullet points.

## How to set up DC 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 DC 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": "opendata-dc-gov/building-permits/get_permit",
    "input": {
      "permit_number": "<permit_number>"
    }
  }'
```

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

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

## DC building permit details tools and prices

- [Washington, DC Building Permits (opendata.dc.gov) · Get permit](https://spiral.ai/tools/alexandria/opendata-dc-gov/building-permits/get_permit) (Alexandria): $0.00873 per call.

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

Build a DC permit timeline or construction report using published addresses, issue dates, statuses, and work descriptions. A coding agent can connect those records to the project's existing tables and reporting code.

### Commercial property permit review

Find permits for a commercial address, then inspect the relevant records to build a dated account of alterations and their published statuses.

### Public facility renovation brief

Gather permit records for a library, school, or recreation center and examine the work descriptions for a concise renovation brief.

### Construction activity report

Compare matching permit records by issue month and work type, then inspect individual permits to explain notable projects.

### Commercial site watch

Check for recently issued permits at selected business properties and review the underlying records before preparing an activity alert.

### Permit status comparison

Collect records for a commercial project and compare their published statuses over time, checking individual permits when a difference appears.

### Reporting on neighborhood development

Find construction and alteration permits in a DC area, then inspect selected records to support reporting with permit numbers, dates, addresses, and work descriptions.

## Overview

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

## DC building permit details in other agents

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

## More opencode guides

- [Craigslist housing search](https://spiral.ai/integrations/opencode/craigslist-housing-search)
- [DC building permit search](https://spiral.ai/integrations/opencode/dc-building-permit-search)
- [Craigslist housing regions](https://spiral.ai/integrations/opencode/craigslist-housing-regions)
- [DataSF catalog categories and tags](https://spiral.ai/integrations/opencode/datasf-catalog-categories-and-tags)
- [Craigslist housing posting details](https://spiral.ai/integrations/opencode/craigslist-housing-posting-details)
- [DataSF dataset details](https://spiral.ai/integrations/opencode/datasf-dataset-details)

## Questions about DC building permit details in opencode

**Can opencode use DC building permit details?**

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

**How much does DC 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 DC building permit details in opencode?**

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

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

**Does opencode wait while DC building permit details runs?**

DC 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 does the permit data cover?**

It covers building construction and alteration permits from the District of Columbia Department of Buildings. It is a DC source, so it does not provide a regional permit history for neighboring Maryland or Virginia jurisdictions.

**How far back does DC publish permit data?**

DC's source service lists annual permit layers spanning 2009 through 2026. That establishes the published year range, not a guarantee that every historical permit is present.

**How often is the source updated?**

DC's building-permit metadata specifies daily updates. That is a publication schedule, not a promise that a permit appears immediately after an agency action.

**Does a modified date mean the permit changed?**

The metadata defines LASTMODIFIEDDATE as the date of a successful transfer from DOB. Compare the published status and work description before describing a refreshed record as a changed permit.

**Can I rely on every permit's map location?**

No. DC warns that failed address matches can produce 0,0 coordinates, which require manual geocoding before they can support location analysis.

