Tools reference

The connector has 17 tools: 8 that read and 9 that write. Read tools are marked readOnlyHint: true, so Claude can run them freely and ask before a write. You do not call these yourself. Claude picks them based on what you ask.

Every tool acts as the person who signed in. See Data and permissions for how that limits results.

Read toolsCopy Anchor Link

search_signalsCopy Anchor Link

Searches recent project signals in your organization's markets, plus 2 miles past their edges, newest first. It has no keyword or date input. To answer "this week", Claude reads the newest results and checks their dates.

Returns: a list with id, siteId, type, jurisdiction, title, address, acres, occurredAt, and sourceUrl.

Example: "Show me new ground sites in Virginia Beach."

{ "jurisdiction": "51810", "siteStages": ["new_ground"], "limit": 25 }

market_overviewCopy Anchor Link

Counts project signals by locality and by type, to show where activity is. These counts cover everything Huff tracks, not only your markets. They are totals and include no site details.

No inputs.

Returns: totalSignals, byJurisdiction, and byType.

Example: "Where is the most activity right now?"

get_siteCopy Anchor Link

Opens one site: its project signals with source links, the companies and people tied to it with any contact details on record, and whether your team is pursuing it.

Returns: id, name, jurisdiction, address, acres, stage, lastActivityAt, signals, parties, and pursuit. Each entry in parties has an entityId that adopt_operator accepts. For a site outside your markets, it returns only outside: true and the jurisdiction.

Example: "Who is working on that site?"

{ "siteId": "<siteId from search_signals>" }

list_routable_sitesCopy Anchor Link

Lists the sites on open Pipeline leads across your organization that have a map point, newest lead first. Use it to find the ids for create_route.

No inputs.

Returns: a list with id, name, jurisdiction, address, lat, and lng.

Example: "Which of the sites we're pursuing can I drive to?"

get_accountCopy Anchor Link

Opens one company in your organization, with its contacts and most recent interactions.

Returns: account, contacts, and interactions.

Example: "When did we last talk to that contractor?"

{ "accountId": "<accountId from list_accounts>" }

list_accountsCopy Anchor Link

Lists the companies in your organization, in name order, a page at a time.

Returns: items, total, limit, and offset.

Example: "List the first 50 companies in my book."

{ "limit": 50, "offset": 0 }

list_pipelineCopy Anchor Link

Lists leads, newest first, with the place, its stage, its owner, and a source link. You see the teams you sit on. Owners and admins see the whole organization. Someone on no team sees leads that have no team.

Returns: a list of leads.

Example: "What are we still working on?"

{ "kind": "open" }

list_stagesCopy Anchor Link

Lists the stages on a team's board, in order, with the ids set_lead_stage needs. Your organization names its stages. Each stage's kind is the fixed meaning behind it: open, won, or lost.

Returns: the board and its stages.

Example: "What stages can a lead be in?"

Write toolsCopy Anchor Link

start_pursuingCopy Anchor Link

Puts a site on a team's Pipeline at that team's first open stage. Leads belong to the team, so everyone on it sees the same board. A site outside your markets is refused as if it did not exist.

Returns: the new lead.

Example: "Start pursuing that site."

{ "siteId": "<siteId from search_signals>", "notes": "Asked about rental for the clearing work." }

set_lead_stageCopy Anchor Link

Moves a lead to another stage on its team's board. You can move your own team's leads. Owners and admins can move any lead in the organization.

Returns: the updated lead.

Example: "Move that lead to Quoted."

{ "leadId": "<leadId from list_pipeline>", "stageId": "<stageId from list_stages>" }

drop_leadCopy Anchor Link

Removes a lead from its team's Pipeline. You can drop your own team's leads. Owners and admins can drop any lead in the organization. The site can be pursued again later as a new lead.

Returns: removed, with the lead's id.

Example: "Drop the Oak Street lead. We lost interest."

{ "leadId": "<leadId from list_pipeline>" }

create_accountCopy Anchor Link

Adds a company to your organization's Companies.

Returns: the new company.

Example: "Add Tidewater Site Partners as a site contractor."

{ "name": "Tidewater Site Partners", "segment": "site_contractor" }

add_contactCopy Anchor Link

Adds a person to a company in your organization.

Returns: the new contact.

Example: "Add Dana Reyes as their project manager."

{ "accountId": "<accountId from list_accounts>", "name": "Dana Reyes", "title": "Project manager" }

log_interactionCopy Anchor Link

Records a touch on a company. Interactions logged this way are marked as made through AI, and Claude cannot change that mark.

Returns: the new interaction.

Example: "Log a call with Dana. They want a quote by Friday."

{
  "accountId": "<accountId from list_accounts>",
  "kind": "call",
  "summary": "Dana wants a quote by Friday."
}

create_routeCopy Anchor Link

Creates a driving route from site stops, in the order given. The route belongs to you. Every site needs a map point and has to be inside your markets, or the route is refused.

Returns: the new route.

Example: "Make a route called Tuesday north with those three sites."

{ "name": "Tuesday north", "siteIds": ["<siteId>", "<siteId>", "<siteId>"] }

optimize_routeCopy Anchor Link

Reorders the stops on one of your routes for the shortest drive. With a starting point, Huff solves the day from there and no stop is pinned. Send both coordinates or neither.

Returns: routeId and outcome, which is one of:

• reordered: the stops have a new order.
• already-optimal: the order was already the shortest.
• too-small: there are too few stops to reorder.
• unmappable: a stop has no map point.
• no-trip: no drive could be worked out.

Example: "Put that route in the shortest order, starting from here."

{ "routeId": "<routeId from create_route>", "originLat": 36.85, "originLng": -75.98 }

adopt_operatorCopy Anchor Link

Adds a company named on a site to your Companies and links it, so its company page shows its other projects. Running it twice returns the existing company instead of a duplicate.

Returns: the company, new or existing.

Example: "Add that site's developer to my Companies."

{ "entityId": "<entityId from get_site>", "segment": "developer_owner" }