How to Use Pittsburgh permit search in Windsurf
Finds Pittsburgh permits by location, contractor, or described work, returning matching records from WPRDC. Use it to discover projects and compare activity before examining an individual permit.
Prompts to try with Pittsburgh permit search in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Pittsburgh permit search for solar work in ZIP code 15212 and add the returned records to a CSV in this project.
Use Pittsburgh permit search for demolition work in ZIP code 15222 and build a table of the matching permit identifiers.
Use Pittsburgh permit search for roof work in ZIP code 15212 and create a map from the returned coordinates.
Use Pittsburgh permit search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Pittsburgh permit search and tell me what changed since last week.
How to set up Pittsburgh permit search in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Pittsburgh 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": "data-wprdc-org/building-permits/search_permits", "input": { "zip": "<zip>" } }'
Then paste one of the prompts above: Windsurf finds Pittsburgh permit search on Spiral, shows the price and runs it.
Pittsburgh permit search providers and prices
Spiral runs Pittsburgh permit search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Sort | issued_desc or valuation_desc | issued_desc | issued_desc: newest issued first; valuation_desc: largest project value first. |
| Limit | 1 to 100 | 25 | Rows per page. |
| Permit class | commercial or residential | commercial or residential. | |
| Min valuation | 0 to 1000000000000 | Only permits whose total project value is at least this many USD. |
Every API field of WPRDC (data.wprdc.org): Pittsburgh permits, code violations, condemnations and contractor licences · Search permits is on its tool page: open its card above.
What can you do with Pittsburgh permit search in Windsurf?
Build a Pittsburgh project map or permit review table using published locations and work descriptions. A coding agent can turn the records into project files and add checks for repeated permit identifiers.
Commercial site research
Find permits for a prospective Pittsburgh business location, then examine individual records for the described work and current published status.
Construction reporting
Find projects in a ZIP code and inspect selected permits to build a reporting shortlist grounded in work descriptions and projected project values.
Contractor project research
Search a public contractor business's permit records and review individual projects to understand the kinds of work recorded under that business.
Solar installation research
Find permits whose descriptions mention solar work, then inspect the selected records to distinguish the actual scopes described.
Commercial project status review
Discover permits for selected business properties and revisit individual records to compare their published statuses over time.
Permit map preparation
Collect permits for an area and examine individual records before mapping their published coordinates, with work descriptions attached to each project.
More on Pittsburgh permit search and Windsurf
Overview
Pittsburgh permit search in other agents
Questions about Pittsburgh permit search in Windsurf
Can Windsurf use Pittsburgh permit search?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Pittsburgh permit search like any built-in tool.
How much does Pittsburgh permit search cost in Windsurf?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need an Alexandria account to use Pittsburgh permit search in Windsurf?
No. Spiral runs Pittsburgh 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 Pittsburgh permit search in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Pittsburgh permit search runs?
Pittsburgh permit search runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.
Does this cover all of Allegheny County?
The documented coverage is permits issued by Pittsburgh's PLI department, beginning June 1, 2019. It is a city permit dataset, so a county parcel identifier does not establish countywide coverage.
How fresh are the permit records?
WPRDC lists daily data changes and daily publishing. That is a daily publication schedule, not a promise that a city transaction appears immediately.
Can I count returned rows as separate permits?
The dictionary explicitly warns that one permit may appear in multiple rows because of associated street closures. Count distinct permit identifiers when reporting permit totals.
Why do newer records mention Building and Development Applications?
Pittsburgh launched that application in June 2024 to combine building permits and zoning approval. When comparing construction records across that date, account for the change in terminology.
Can I reuse the published permit data?
WPRDC links a Creative Commons Attribution license, which allows reuse and redistribution with appropriate credit. Include source attribution when publishing a permit table or analysis.
Start using Pittsburgh permit search in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


