Permit MCP
Planned jurisdiction adapter for Salesforce/Shape-Phoenix permit portals, intended to map permit and inspection data into the standard Permit MCP model. Not built yet.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Permit MCP Standard
An open standard and reference MCP server for building permits, so any AI harness (Claude, ChatGPT, Codex, Grok) can manage permits and inspections the same way.
For: general contractors, subcontractors, and anyone in residential building juggling permits across multiple city portals and inspections.
The problem
Every city has its own portal, forms, statuses, fees, and inspection rules. Contractors track it all by hand across tabs, emails, and spreadsheets.
Related MCP server: CivicDataForge
What this standard defines
Common data model: Permit, Project, Inspection, Jurisdiction, Document, Fee, Status (
spec/schemas/).Standard MCP tools: the same tool names and shapes regardless of city or harness.
Jurisdiction adapters: one plugin per city portal that maps its quirks to the common model.
Harness packaging: install configs for Claude, ChatGPT, Codex, Grok (
adapters/).
Quick start
git clone https://github.com/tracewalters/Permit-MCP && cd Permit-MCP
npm install && npm run build
node dist/cli.js login # pick cities, log in once each (try the "Demo City": demo / demo)
claude mcp add permit -- node "$PWD/dist/mcp.js"Then ask Claude: "What's the status of all my open permits?"
Every function is also a CLI: permit permits, permit inspections, permit schedule, permit commit. The MCP and the CLI share one implementation (src/service.ts).
Tools
Tool | Purpose |
| Cities you are logged into |
| Permits across all connected cities |
| Detail and inspections for one permit |
| Needed, scheduled, passed, failed |
| Step 1 of a write. Changes nothing |
| Step 2. Runs only after you approve a prompt |
Passwords never go through chat. You enter them in the terminal (permit login). They are stored encrypted (AES-256-GCM) on your machine.
Status
Working end to end with the fixture-backed demo adapter. Real adapters for Salesforce/Shape-Phoenix, Tyler, Accela, and OpenGov are planned, not built yet. See docs/CONTRIBUTING.md to add one.
Repo layout
src/ CLI, MCP server, service layer, vault, adapters
data/ Jurisdiction list
test/ Tests (node:test)
apps/web/ Marketing, docs, billing and usage site
spec/ Standard text and JSON schemas
adapters/ Per-harness install configs
docs/ Architecture, vision, self-improving loop, contributingSee VISION.md and docs/ARCHITECTURE.md.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Resolve any government entity worldwide and submit service requests. Open civic data for AI agents.
Chicago building permits: contractors, costs, timelines and work descriptions. Normalized API.
Pull recent building permits from 9 US cities in a unified schema from official open-data portals.
Building-permit verdicts by address, with cited records. SF, Seattle, Austin, NYC. Pay per call.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI assistants to query NYC capital project data (schedule, budget, lifecycle) using 16 tools with domain rules like PID↔FMS many-to-many and role-aware agency attribution.182MIT
- AlicenseAqualityBmaintenanceProvides MCP-compatible agents structured access to official government records, including short-term rental permits, healthcare exclusions, childcare licensing, and NYC film permits.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with a Swedish building permit case management system, allowing case overview, listing, retrieval, summarization, status updates, note addition, and creation of cases through natural language.ISC
- FlicenseAqualityBmaintenanceEnables construction permitting teams to analyze portfolios of active permits by ranking risk, detecting day-over-day changes, identifying systemic bottlenecks, and generating daily executive action plans. Also supports single-permit readiness audits, missing-document reports, blocker explanations, resubmission checklists, and semantic search over municipal requirements.71-