MCP server · version 1.1.0

Connect your AI to Groundbreak

Ask Claude, ChatGPT, Cursor or any MCP client about the public record in 7 markets: permits, deeds, loans and liens, the projects behind them and the companies on them. Look up who owns a property and who is behind the LLC, and work your deals in the CRM. 22 tools, one account.

Serverhttps://crm.groundbreak.city/api/mcp

Point your agent athttps://crm.groundbreak.city/docs/mcp.md

Auth: the Claude app, ChatGPT and other clients that sign in with OAuth need only the server address. Others send Authorization: Bearer <your key>. Make a key, free with any account.

Connect

The Claude app and ChatGPT sign in: paste the address and approve. For the others, make a key at Connect AI, one per client; the setup there has it filled in.

Run this in a terminal. Every Claude Code session gets Groundbreak. Or leave out the header and run /mcp in Claude Code to sign in instead.

Terminal

claude mcp add --transport http groundbreak https://crm.groundbreak.city/api/mcp \
  --header "Authorization: Bearer <your key>"

Tools

Every result carries app links. Tools that change your CRM or spend credits say so in their description, and a good client asks you first.

The database

Permits, deeds, loans, notices of commencement, zoning cases and liens in every market, the projects they belong to and the companies on them. Parties on anything filed in the last 90 days come back with Pro; older records come back whole on any account.

search_records

Reads

Search Groundbreak's public-record filings in one market: building permits, deeds, loans, notices of commencement (starts), zoning and site plan cases, liens. Returns up to 25 rows, newest or biggest first, with the true count, the source record and an app link. Parties and phones on filings from the last 90 days come back on Pro; older filings come back whole for everyone.

marketrequired: austin | atlanta | miami | nashville | tampa | charlotte | dfwMarket: austin (Austin), atlanta (Atlanta), miami (Miami), nashville (Nashville), tampa (Tampa Bay), charlotte (Charlotte), dfw (Dallas-Fort Worth)
q: stringAddress, project or scope text
kind: all | permits | instruments | deeds | loans | starts | cases | distressinstruments is deeds and loans; distress is liens and lis pendens
days: integer, 1 to 365Window back from today, default 30; ignored when from is set
from: date (YYYY-MM-DD)Start date YYYY-MM-DD
to: date (YYYY-MM-DD)End date YYYY-MM-DD, inclusive
min: number, 0 or moreMinimum dollar value
sort: date | valuedate (default) for the newest, value for the biggest

search_projects

Reads

Find development projects in one market by name or address. Returns status and an id for get_project.

marketrequired: austin | atlanta | miami | nashville | tampa | charlotte | dfwMarket: austin (Austin), atlanta (Atlanta), miami (Miami), nashville (Nashville), tampa (Tampa Bay), charlotte (Charlotte), dfw (Dallas-Fort Worth)
qrequired: stringProject name or street address

get_project

Reads

One project's file: status, specs, the team (developer, architect, GC), its filings with values, the owner of record and what changed. Parties and the owner are Pro unless nothing has filed on the project in 90 days, when the file is open to any account.

marketrequired: austin | atlanta | miami | nashville | tampa | charlotte | dfwMarket: austin (Austin), atlanta (Atlanta), miami (Miami), nashville (Nashville), tampa (Tampa Bay), charlotte (Charlotte), dfw (Dallas-Fort Worth)
idrequired: idProject id from search_projects or search_records

search_companies

Reads

Find companies in one market by name: developers, GCs, trade subs, architects and engineers, lenders, owners. Returns their roles, live projects, filings in the last 90 days and 12 months, permit value, deeds and loans, and an app link.

marketrequired: austin | atlanta | miami | nashville | tampa | charlotte | dfwMarket: austin (Austin), atlanta (Atlanta), miami (Miami), nashville (Nashville), tampa (Tampa Bay), charlotte (Charlotte), dfw (Dallas-Fort Worth)
qrequired: stringCompany name, or part of it

Properties and owners

Any Florida property, and the county rolls Groundbreak reads outside Florida. Find the owner, the people behind an LLC (Florida, from Sunbiz), their phones, and the public record on the parcel.

lookup_property

Reads

Look up a property by street address, parcel id or folio, or every parcel an owner name holds: any Florida property on the statewide tax roll, and outside Florida any parcel in Travis, Dallas, Tarrant, Fulton, DeKalb, Davidson and Mecklenburg counties on the county rolls Groundbreak reads. Returns the owner, mailing address, use, size, value and last sale. Writes nothing; add_property saves one to the workspace.

qrequired: stringA street address with city (and state outside Florida), a parcel id or Miami-Dade folio, or an owner name such as an LLC

groundbreak_records

Reads

The public record for an address or parcel without adding it: appraiser sales, plus what Groundbreak reads in its markets (Miami: permits, trade subs, deeds, construction loans and notices of commencement; Atlanta: permits, planning cases and DeKalb deeds & loans; Nashville: permits, Planning Commission cases and sales; Austin: permits, site plan and zoning cases and TDLR registrations; Tampa Bay: permits, deeds, mortgages and notices of commencement; Charlotte: permits, rezoning petitions and owners of record; Dallas-Fort Worth: permits, deeds of trust, deeds and zoning cases); City of Orlando permits in Orlando. Elsewhere only the appraiser roll.

qrequired: stringStreet address with city (and state outside Florida), or a parcel id or folio

add_property

Changes your CRM

Add a parcel to the workspace. Pulls the county record and makes the owner an owner record; for a Florida property it reads the owner's Sunbiz filing for the people behind it (free). Returns the property with links. Use the county and parcel_id from lookup_property.

countyrequired: stringCounty name as lookup_property returned it, e.g. Miami-Dade, Orange, Travis, Dallas, Fulton
parcel_idrequired: stringParcel id exactly as lookup_property returned it

get_property

Reads

A property in the workspace: facts, owner, the people behind the owner, deals, and the public record (sales, deeds, mortgages, liens, lis pendens, permits) with title flags.

idrequired: idProperty id

refresh_property_research

Changes your CRM

Re-read the public record for a property in the workspace (appraiser sales, clerk filings, permits). Free.

idrequired: idProperty id

get_owner

Reads

An owner (LLC, corporation, trust or person) in the workspace by id or name: its Sunbiz filing, the people behind it with phones and emails, its properties and deals.

id: idOwner id
name: stringOwner name, when there is no id

trace_owner_people

Changes your CRM

Read the owner's Sunbiz filing and add the managers, members and officers as contacts, following a managing LLC up to two levels. Free. Run before find_phones when an owner has no people yet.

owner_idrequired: idOwner id

find_phones

Spends credits

Skip trace people for phones and emails, with DNC and TCPA litigator flags. Spends one workspace credit per person found; misses are free; anyone traced in the last 30 days is not charged again. Pass owner_id to trace everyone behind an owner, or contact_ids.

owner_id: id
contact_ids: list of id

sunbiz_lookup

Reads

The Florida Division of Corporations filing for an entity by exact name or document number: status, type, filing date, addresses, registered agent and officers. Or, with partial=true, entity names that start with the text.

name: string
doc_number: string
partial: boolean

entities_managed_by

Reads

Every Florida entity a person or company is listed on as a manager, member or officer: the portfolio behind a name. Names as Sunbiz writes them, e.g. "PINTO, MIGUEL A" or "PINTO MIGUEL A".

namerequired: string

Your CRM

The deals, people, notes and tasks in your workspace. Writes land on the timeline marked as made over MCP.

search_crm

Reads

Search this workspace: deals, owners, properties and people by name or address.

qrequired: string

list_deals

Reads

Deals in the pipeline, optionally one stage or a name search. Stages: prospect, contacted, meeting, proposal, signed, contract, closed, lost (or the workspace's own).

stage: string
q: string

get_deal

Reads

One deal: stage, value, property, owner, the people on it with phones, the last 20 timeline entries, open tasks and the title snapshot.

idrequired: id

create_deal

Changes your CRM

Create a deal in the pipeline, optionally tied to a property, owner and contacts. Stage defaults to the first stage.

namerequired: string
stage: string
side: listing | acquisition | lease | financing | other
value: number, 0 or moreExpected price or deal size in dollars
property_id: id
owner_id: id
contact_ids: list of id

move_deal

Changes your CRM

Move a deal to another stage. Entering Signed or Under contract takes a title snapshot from the county record.

idrequired: id
stagerequired: stringStage key or label
lost_reason: string

add_note

Changes your CRM

Log a note, call, email or meeting on a deal, contact, owner or property timeline. Calls, emails and meetings update the contact's last touch.

bodyrequired: string
kind: note | call | email | meeting
deal_id: id
contact_id: id
owner_id: id
property_id: id

create_task

Changes your CRM

Create a task (a call back, a follow-up), optionally due on a date and tied to a deal or contact. Assigned to the caller unless assignee_email names a teammate.

titlerequired: string
due: stringYYYY-MM-DD or an ISO time
deal_id: id
contact_id: id
assignee_email: string

list_tasks

Reads

Tasks in the workspace: open ones by default, the caller's own when mine=true.

open: boolean
mine: boolean

Markets

Pass a market by its id. What each one holds comes from the public record, and some records are not public everywhere.

Market	Records	Not in the record	Properties
Austin, TXaustin	permits, site plan and zoning cases and TDLR registrations	sales name buyer and seller with no price; no loans; no notices of commencement; no liens or lis pendens	Properties in Travis County, TX. Naming the people behind an LLC is Florida only.
Atlanta, GAatlanta	permits, planning cases and DeKalb deeds & loans	sales name buyer and seller with no price; no notices of commencement	Properties in Fulton and DeKalb counties, GA. Naming the people behind an LLC is Florida only.
Miami, FLmiami	permits, trade subs, deeds, construction loans and notices of commencement	·	Any Florida property, from the statewide roll. The people behind an LLC come from Sunbiz.
Nashville, TNnashville	permits, Planning Commission cases and sales	no loans; no notices of commencement; no liens or lis pendens; no phones on permits	Properties in Davidson County, TN. Naming the people behind an LLC is Florida only.
Tampa Bay, FLtampa	permits, deeds, mortgages and notices of commencement	·	Any Florida property, from the statewide roll. The people behind an LLC come from Sunbiz.
Charlotte, NCcharlotte	permits, rezoning petitions and owners of record	no sales; no loans; no notices of commencement; no liens or lis pendens	Properties in Mecklenburg County, NC. Naming the people behind an LLC is Florida only.
Dallas-Fort Worth, TXdfw	permits, deeds of trust, deeds and zoning cases	sales name buyer and seller with no price; no notices of commencement	Properties in Dallas and Tarrant counties, TX. Naming the people behind an LLC is Florida only.

Plans and limits

Pro returns the parties on filings from the last 90 days. Without Pro those come back withheld, and older filings come back whole.

Plan	Tool calls a minute	Tool calls a day
Pro	60	2,000
Without Pro	20	100

Limits count tool calls per person, across all of that person's keys. Connecting and listing tools are free. Daily limits reset at midnight UTC. Your calls are on Connect AI.

find_phones spends 1 credit for each person it finds a phone or email for. Misses are free, and anyone traced in the last 30 days is free again.
Pro ($27 a month) adds 50 credits to your workspace each month. A pack adds 200 for $27 and they keep.
Every other tool is free. Sunbiz people, phones on permits and owners of record never cost a credit.

Errors

What	What it looks like	What to do
Not signed in, or a wrong, revoked or expired key	HTTP 401 with JSON-RPC error -32001 and a WWW-Authenticate header	A client that signs in starts the sign-in from that header; an expired sign-in refreshes on its own. Otherwise make a key at https://crm.groundbreak.city/connect and check the client sends it.
Past the limit	A tool result with isError and "past the fair-use limit of ..."	Wait for the window to reset: a minute, or midnight UTC. For more, email max@groundbreak.city.
A read key asked to write	A tool result with isError and "This key reads only"	Use a key with full access for that client.
Arguments the tool does not take	A tool result with isError and "Invalid arguments: ..."	The message names the field. The tool list carries each input schema.
A refusal meant for you	A result with an error field: an id from another workspace, no credits left	Read it to the person: it says what to do.
A failure on our side	A tool result with isError and "That tool failed on our side"	We are told when this happens. Try again in a moment.

Keys and safety

A key, or an app you signed in to, acts as you in the workspace you picked. It reads everything you can.
With full access it also logs notes, makes and moves deals and spends credits in your name. Read only sees only the tools that read.
Make one key per client, so you can revoke one without the others. Revoking a key or disconnecting an app on Connect AI stops it at once.
A key in a URL lives in that client's settings. Treat the URL like a password, and prefer signing in where the client can.

Protocol

JSON-RPC 2.0 over HTTP POST, Streamable HTTP. Methods: initialize, ping, tools/list, tools/call. Batches work.
Answers are plain JSON, never an event stream. No sessions: every request stands alone. GET answers 405.
Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.
A result longer than 60,000 characters comes back with its longest lists cut and a trimmed note.
Tools carry readOnlyHint. On connect the server tells the client the workspace, the plan, the limits and the credits left.
OAuth 2.1: a request without a token gets a 401 whose WWW-Authenticate names the resource metadata; the server metadata lists the endpoints. Dynamic client registration, PKCE (S256 only), scopes mcp:full and mcp:read. Access tokens last 60 minutes; refresh tokens 90 days, replaced on every use.

Try asking

The 10 biggest permits filed in Miami in the last 30 days, with the contractor on each
Mortgages recorded in Tampa in the last 60 days: lender, borrower and amount
Find the project at an address I give you and list its developer, architect and GC
What has a company I name filed in Atlanta in the last year?
Look up an address I give you: who owns it, and who is behind the LLC?
Which deals in my pipeline have no phone for the owner yet?
Log a call with the owner on my newest deal and set a follow-up for Friday