Spiral gives your agent every tool with one account. Browse the tools →

Hermes · Listings

How to Use DC building permit search in Hermes

Finds DC permit records for an address, parcel, work type, or issue-date range. Use it to assemble a site's permit history or compare construction activity across matching records.

Prompts to try with DC building permit search in Hermes

Copy an example into Hermes, or ask in your own words.

Every Monday, use DC building permit search to find permits issued in the past seven days for 50 Massachusetts Avenue NE, Washington, DC, and summarize any results.

DC building permit searchHermes
Try asking
  • Every Friday, use DC building permit search to find construction permits issued in DC ZIP code 20002 during the past seven days and summarize them by permit type.

  • On the first day of each month, use DC building permit search to find permits issued during the previous month for 1500 South Capitol Street SE, Washington, DC, and prepare a dated activity brief.

  • Every Monday at 9am: use DC building permit search to look this up and give me the result as a table.

  • Pull the latest numbers from DC building permit search and tell me what changed since last week.

How to set up DC building permit search in Hermes

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

Use the Spiral skill

  1. Send Hermes 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 Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    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 search

    One request; the result comes back by polling or a webhook.

    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/search_permits",
        "input": {
          "zip": "<zip>"
        }
      }'

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

DC building permit search providers and prices

Spiral runs DC building permit search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaListings
Washington, DC Building Permits (opendata.dc.gov) · Search permits
opendata-dc-gov/building-permits/search_permits

Settings you can ask for

Ask Hermes for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Sortissued_descissued_desc

Newest issue date first (ties by permit id). The only order: DC publishes no application date or valuation, and its row-modified date is rewritten in bulk.

Limit1 to 10025

Records per page.

Every API field of Washington, DC Building Permits (opendata.dc.gov) · Search permits is on its tool page: open its card above.

What can you do with DC building permit search in Hermes?

Keep a recurring DC construction brief current with newly found permits and comparisons of previously reviewed records. A scheduled agent can check selected commercial or public sites and report substantive differences in published permit contents.

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.

Questions about DC building permit search in Hermes

Can Hermes use DC building permit search?

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

How much does DC building permit search cost in Hermes?

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

Do I need an Alexandria account to use DC building permit search in Hermes?

No. Spiral runs DC 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 DC building permit search in Hermes?

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

Does Hermes wait while DC building permit search runs?

DC building permit search runs in the background. Hermes 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.

Get started

Start using DC building permit search in Hermes

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Hermes:

Set up Hermes

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options