[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Boston zoning appeals](https://spiral.ai/integrations/claude-code/boston-zoning-appeals)

# How to Use Boston zoning appeals in Claude Code

Find Boston appeal records with case status, hearing dates, application numbers, and recorded outcomes from the city's ZBA tracker. Use it to research proposed development or prepare a neighborhood hearing brief.

|  |  |
| --- | --- |
| Model | Boston zoning appeals |
| 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 Boston zoning appeals in Claude Code

- Use Boston zoning appeals to fetch Dorchester cases and add a table to this project showing address, application number, status, hearing date, and recorded outcome.
- Use Boston zoning appeals to retrieve Jamaica Plain cases and create a CSV export of their application numbers, hearing dates, and hearing results.
- Use Boston zoning appeals to fetch South Boston cases, save the results in this project, and write a comparison that detects changed hearing dates on the next run.
- Use Boston zoning appeals to search Newbury Street and build an address-based case list in the project's existing report format.
- Use Boston zoning appeals to retrieve Roxbury cases in community process and populate the neighborhood planning view in this project.

## How to set up Boston zoning appeals in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Boston zoning appeals**: 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-boston-gov/zoning-appeals/search_zoning_appeals",
    "input": {
      "zip": "<zip>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds Boston zoning appeals on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Boston zoning appeals tools and prices

- [Analyze Boston: building permits, zoning appeals and violations (data.boston.gov) · Search zoning appeals](https://spiral.ai/tools/alexandria/data-boston-gov/zoning-appeals/search_zoning_appeals) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| zip |  | — | 5-digit ZIP code (02127). Pattern: ^[0-9]{5}$. |
| sort | received_desc, hearing_desc, hearing_asc, decided_desc | received_desc | received_desc: newest received first; hearing_desc or hearing_asc by hearing day; decided_desc: newest decision first. Rows without the sort day come last. |
| limit | 1 to 100 | 25 | Rows per page. |
| cursor |  | — | next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. |
| status |  | — | Case-insensitive substring of the status: scheduled, concluded, finalized, closed, community process, submitted. |
| address |  | — | Street line, case-insensitive substring (50 Cromwell Road, 840 Columbus Ave). Text after a comma is ignored; a trailing Street, Avenue, Road, Boulevard, Place and similar becomes ISD's abbreviation (ST, AV, RD, BL, PL). Ranges are written 140-148 Brookline AV, so a number inside a range does not match. |

## What can you do with Boston zoning appeals in Claude Code?

Build a Boston appeal table that shows each project's application number, status, hearing date, and outcome. Add neighborhood views and comparisons between saved results to support development research.

### Neighborhood hearing brief

Collect appeals in Dorchester and organize the returned cases by scheduled hearing date, with the address, application number, and status.

### Commercial corridor research

Review appeals along Newbury Street to assemble a case list for a business district planning report.

### Development case history

Search a proposed development's address and summarize the recorded appeal milestones and outcomes for a project briefing.

### Hearing date change watch

Compare successive searches for South Boston appeals and flag cases whose scheduled hearing dates have changed.

### Recorded outcome comparison

Compare returned approvals and denials across Jamaica Plain and Dorchester, identifying the appeal records behind each count.

### Community process briefing

Gather appeals marked as being in community process in Roxbury for a neighborhood organization's planning discussion.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Boston zoning appeals in other agents

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

## More Claude Code guides

- [Boston contractor permit activity](https://spiral.ai/integrations/claude-code/boston-contractor-permit-activity)
- [Cambridge building permit details](https://spiral.ai/integrations/claude-code/cambridge-building-permit-details)
- [Boston building permit search](https://spiral.ai/integrations/claude-code/boston-building-permit-search)
- [Cambridge building permit search](https://spiral.ai/integrations/claude-code/cambridge-building-permit-search)
- [Boston building permit details](https://spiral.ai/integrations/claude-code/boston-building-permit-details)
- [Cambridge contractor permit activity](https://spiral.ai/integrations/claude-code/cambridge-contractor-permit-activity)

## Questions about Boston zoning appeals in Claude Code

**Can Claude Code use Boston zoning appeals?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Boston zoning appeals like any built-in tool.

**How much does Boston zoning appeals cost in Claude Code?**

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

**Do I need an Alexandria account to use Boston zoning appeals in Claude Code?**

No. Spiral runs Boston zoning appeals on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Boston zoning appeals in Claude Code?**

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

**Does Claude Code wait while Boston zoning appeals runs?**

Boston zoning appeals runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does the tracker cover every Boston construction project?**

Each record represents an appeal of a denied permit application. It is an appeal dataset, so its case counts should not be presented as total construction activity.

**What details does Boston publish about an appeal?**

The city's guide lists appeal status, hearing dates and results, application numbers, zoning district, and submission date. These details support case research and neighborhood hearing briefs.

**Are scheduled hearing dates fixed?**

Boston's guide says ZBA hearing dates are tentative and subject to change. A scheduled date should therefore be described as tentative in a hearing brief.

**Does an approval vote mean the decision is final?**

Boston's guide says the decision becomes final after the written decision is filed with ISD. A hearing outcome and a filed final decision represent different milestones.

**How often is the appeal data updated?**

Statnorth's listing of the Boston tracker says the publisher does not list an update schedule. That evidence does not establish a daily refresh or immediate publication after a hearing.

