[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Seattle contractor permit activity](https://spiral.ai/integrations/hermes/seattle-contractor-permit-activity)

# How to Use Seattle contractor permit activity in Hermes

Returns contractor rankings by permits issued from Seattle's building, trade, or electrical records. Use it to compare recorded activity, keeping the building dataset's sparse contractor coverage in mind.

|  |  |
| --- | --- |
| Model | Seattle contractor permit activity |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Seattle contractor permit activity in Hermes

- Every Monday, use Seattle contractor permit activity to report roofing contractor activity across Seattle for the previous calendar month, including the building coverage limitation.
- On the first Monday of each month, use Seattle contractor permit activity to compare electrical contractors in Seattle ZIP code 98109 for the previous calendar month.
- Every Monday at 9am: use Seattle contractor permit activity to look this up and give me the result as a table.
- Pull the latest numbers from Seattle contractor permit activity and tell me what changed since last week.
- Check Seattle contractor permit activity and summarize what you find in three bullet points.

## How to set up Seattle contractor permit activity 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.

```bash
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`.

```bash
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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Seattle 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": "data-seattle-gov/building-permits/contractor_activity",
    "input": {
      "issued_since": "<issued_since>"
    }
  }'
```

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

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

## Seattle contractor permit activity tools and prices

- [City of Seattle Open Data: permits and land use decisions · Contractor activity](https://spiral.ai/tools/alexandria/data-seattle-gov/building-permits/contractor_activity) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| zip |  | — | Only permits at sites in this ZIP code. Pattern: ^[0-9]{5}$. |
| kind | building, trade, electrical | building | Which dataset to rank: building (Building Permits; contractor named on about a sixth of permits), trade or electrical (contractor named on most permits). |
| limit | 1 to 100 | 25 | Records per page. |
| cursor |  | — | The next_cursor of the previous page. Pattern: ^[0-9]{1,7}$. |
| permit_type |  | — | Only permits whose type, class or work type matches these words, for example New, Roof, Furnace, Commercial. |
| issued_until |  | — | Last issue date, inclusive (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |

## What can you do with Seattle contractor permit activity in Hermes?

Keep a recurring Seattle construction brief current with the source's nightly refresh. A scheduled agent can revisit permit records and compare recorded contractor activity across completed reporting periods.

### Roofing contractor comparison

Compare contractors' recorded roofing permit activity, examine their matching projects, and review selected permit records. Explain how missing contractor names limit the comparison.

### Electrical contractor shortlist

Identify businesses with recorded electrical permit activity in a Seattle ZIP code, inspect their projects, and assemble examples of relevant work for further review.

### Mechanical work market brief

Research mechanical trade permits, compare contractors' recorded activity, and read selected projects to understand the work described in the records.

### Construction business reporting

Prepare a Seattle construction bulletin using contractor rankings, project searches, and full records for examples. Describe rankings as recorded permit activity rather than total business revenue.

## Overview

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

## Seattle contractor permit activity in other agents

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

## More Hermes guides

- [SeatGeek venue search](https://spiral.ai/integrations/hermes/seatgeek-venue-search)
- [Seattle permit details](https://spiral.ai/integrations/hermes/seattle-permit-details)
- [SeatGeek venue details](https://spiral.ai/integrations/hermes/seatgeek-venue-details)
- [Seattle permit search](https://spiral.ai/integrations/hermes/seattle-permit-search)
- [SeatGeek search suggestions](https://spiral.ai/integrations/hermes/seatgeek-search-suggestions)
- [SevenRooms reservation availability](https://spiral.ai/integrations/hermes/sevenrooms-reservation-availability)

## Questions about Seattle contractor permit activity in Hermes

**Can Hermes use Seattle contractor permit activity?**

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

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

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

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

**Does Hermes wait while Seattle contractor permit activity runs?**

Seattle contractor permit activity runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Does this cover all of King County?**

The building dataset covers permits within the city of Seattle. The trade and electrical datasets also describe Seattle coverage, so these records do not provide countywide permit activity.

**How fresh are Seattle's permit records?**

The provider describes the records as refreshed nightly. That supports daily research and reporting, but does not establish a live view of changes made during the day.

**How far back does the published history go?**

SDCI says its building and land use datasets include permitting data from 2005. That statement does not establish the same history depth for trade or electrical records.

**Can the published work description change?**

Yes. Seattle says descriptions are subject to change before permit issuance and are generally more stable after issuance, which matters when comparing proposed work with issued projects.

