Skip to content
Back to search

Permit-MCP

Open-source MCP server for permit portals

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tracewalters--permit-mcp/badge.svg)](/listings/tracewalters--permit-mcp)

HTML

<a href="/listings/tracewalters--permit-mcp"><img src="/api/listings/tracewalters--permit-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 55 lines
  1. # Permit MCP Standard
  2. An open standard and reference [MCP](https://modelcontextprotocol.io) server for building permits, so any AI harness (Claude, ChatGPT, Codex, Grok) can manage permits and inspections the same way.
  3. **For:** general contractors, subcontractors, and anyone in residential building juggling permits across multiple city portals and inspections.
  4. ## The problem
  5. Every city has its own portal, forms, statuses, fees, and inspection rules. Contractors track it all by hand across tabs, emails, and spreadsheets.
  6. ## What this standard defines
  7. 1. **Common data model**: Permit, Project, Inspection, Jurisdiction, Document, Fee, Status (`spec/schemas/`).
  8. 2. **Standard MCP tools**: the same tool names and shapes regardless of city or harness.
  9. 3. **Jurisdiction adapters**: one plugin per city portal that maps its quirks to the common model.
  10. 4. **Harness packaging**: install configs for Claude, ChatGPT, Codex, Grok (`adapters/`).
  11. ## Quick start
  12. ```bash
  13. git clone https://github.com/tracewalters/Permit-MCP && cd Permit-MCP
  14. npm install && npm run build
  15. node dist/cli.js login # pick cities, log in once each (try the "Demo City": demo / demo)
  16. claude mcp add permit -- node "$PWD/dist/mcp.js"
  17. ```
  18. Then ask Claude: "What's the status of all my open permits?"
  19. 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`).
  20. ## Tools
  21. | Tool | Purpose |
  22. |---|---|
  23. | `list_connections` | Cities you are logged into |
  24. | `list_permits` | Permits across all connected cities |
  25. | `get_permit` | Detail and inspections for one permit |
  26. | `list_inspections` | Needed, scheduled, passed, failed |
  27. | `propose_inspection` | Step 1 of a write. Changes nothing |
  28. | `commit_action` | Step 2. Runs only after you approve a prompt |
  29. Passwords never go through chat. You enter them in the terminal (`permit login`). They are stored encrypted (AES-256-GCM) on your machine.
  30. ## Status
  31. 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.
  32. ## Repo layout
  33. ```
  34. src/ CLI, MCP server, service layer, vault, adapters
  35. data/ Jurisdiction list
  36. test/ Tests (node:test)
  37. apps/web/ Marketing, docs, billing and usage site
  38. spec/ Standard text and JSON schemas
  39. adapters/ Per-harness install configs
  40. docs/ Architecture, vision, self-improving loop, contributing
  41. ```
  42. See `VISION.md` and `docs/ARCHITECTURE.md`.
  43. ## License
  44. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.