Permity

Permity in Claude

The Permity connector lets Claude look up the building-permit history of a US property address while you talk to it: what work was permitted, when, who issued it, and which of roofing, HVAC, electrical and plumbing have no permit on record. It runs on your Permity account and spends lookups exactly as the website does.

Add it to Claude

You need a Permity account with a plan or credits. Pricing lists the plans.

  1. In Claude, open Settings, then Connectors.
  2. Choose Add custom connector and paste this URL:
https://mcp.permityusa.com/mcp
  1. Choose Connect. Claude opens a Permity page: sign in with your Permity email and password, or with Google, Apple or Microsoft.
  2. Permity shows which app is asking and which account it will use. Choose Allow. Connecting costs nothing.

Allowing creates a key named after the app on your API keys page. Lookups made through Claude are charged to your account like any other. To disconnect, remove the connector in Claude or revoke that key, which stops it at once.

Use an API key instead

Tools that can send a header, such as Claude Code, other AI assistants and your own agents, can skip the sign-in and use a key from your API keys page. Send it as Authorization: Bearer to the same URL. The key works only for its own account, and revoking it stops it at once.

claude mcp add --transport http permity https://mcp.permityusa.com/mcp --header "Authorization: Bearer pk_live_…"

Tools and what they cost

Lookups come out of your plan’s monthly allowance first, and from credits only once the allowance is used up. Opening a report you already have is free. Running a property again is charged. No tool buys credits, changes your plan or charges a card.

ToolWhat it doesWhat it costs
lookup_permitsEvery permit on record for a US property address, newest first, with a summary for roofing, HVAC, electrical and plumbing. Each trade says whether a permit is on record, none is on record, one is on record without a date, or the jurisdiction does not report that trade.The first lookup of a property uses 1 lookup. A property your account looked up in the last 30 days is reopened from the answer you already have, and nothing is charged. An address that matches no property, or more than one, is charged half a lookup.
rerun_lookupRuns a property your account already has again, for a fresh answer inside those 30 days. Claude calls it only when you ask for a fresh lookup after being told what it costs.Always uses 1 lookup.
create_reportFiles a shareable PDF report of a property’s permit history and returns a signed link that opens without a Permity account.Free when your account looked the property up in the last 30 days and that report is still kept. Otherwise it runs the lookup first, which uses 1 lookup.
lookup_building_factsWhat the building is, from the county assessor’s record: year built, floor area, lot, stories, rooms, exterior, roof and basement. No permit history.Half a lookup when facts come back, and nothing when the address cannot be placed or matches more than one parcel. A property your account got facts for in the last 30 days is reopened free.

Every filed report has a link to its PDF, and opening it is free. Every answer says how many lookups your account has left.

Prompts

Two ready-made starting points appear under the connector in Claude. Each asks for an address and then uses lookup_permits, so it costs what that lookup costs.

Pre-purchase permit checkWhat the permit record says about a house before you buy it: the work on record, the trades with no permit on record, and what to ask the seller or an inspector.
What’s been done to this house?Every permitted job on record for an address, in plain words, as a short table.

Example questions

If an address matches more than one property, Claude asks which one you mean rather than picking one.

What you see

In Claude apps that show interactive results, a lookup appears as a report card: the address, the year built where a record has it, the four trades with their status, and every permit with its date, kind of work, description, status, value and the authority that issued it, plus the contractor named on the permit where the county records one. A timeline picture shows each permit by year. Where those apps do not show the card, Claude reads the same answer as text.

Where a record has them, the answer also carries facts about the building such as floor area, lot size, bedrooms and bathrooms. Owner names are not provided through Claude.

A permit on record says work was permitted. No permit on record does not mean no work was done, and a trade the jurisdiction does not report says nothing either way. Permity describes the record, never the condition of the house.

Data and privacy

The connector receives only what a tool is called with: the address, and for some tools a property id, a parcel number or unit, a confirmation token or a note for a report. It does not receive or store your conversation, your chat history or your files.

Permity keeps a usage record of each call (the time, the tool, the address and what it cost) for billing and support, and every answered lookup files a report, kept 90 days and then deleted. The answer is returned to Claude, which handles it under Anthropic’s own terms.

The privacy policy says what we collect, who we share it with and how long we keep it, and the terms say what a report does and does not promise.

Support

Write to admin@valyaai.us. If a tool fails, its message ends with a request id: quote it and we can find the call.