Skip to main content
Glama

Server Details

NYC and US property records: owners, LLC officers, mortgages, pre-foreclosures and investors.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
Hercules Real Estate Data
Claude
–

TDQS

A4.1/5.0

Scored across 28 tools

Disambiguation4/5

Most tools target clearly distinct domains and actions, and descriptions explicitly route agents between NYC, national, investor, LLC, and credit tools. The main ambiguity is between paired quote_/run_ tools and between buy_credits and top_up_credits, but the descriptions clarify those cases.

Naming Consistency4/5

Names are consistently snake_case with verb_noun structure across nearly the whole surface. Minor inconsistency exists where national search uses quote_* while NYC search tools use search_* before a separate run_* tool executes the quote.

Tool Count2/5

At 28 tools, the surface is heavy for a single MCP server. The broad property-data domain justifies some breadth, but many quote_* and run_* pairs substantially inflate the count and could potentially be collapsed or grouped.

Completeness4/5

The server covers NYC lots, units, owners, preforeclosures, signals, underused buildings, national property search/detail, investor and LLC lookup, owner contacts, and credit management. Minor gaps remain, such as no direct national address-to-detail path, but the required quote/run workflow makes the surface workable.

Available Tools

28 tools
buy_creditsBuy credits with a machine paymentAInspect

Buy a credit pack with a machine payment (Stripe MPP: card through a shared payment token, or stablecoin). No account or sign-in needed. Packs: starter_80 = 80 credits for $9.99; pack_200 = 200 credits for $24.99; pack_550 = 550 credits for $59.99; pack_1500 = 1500 credits for $149.99. Pay by card (Stripe Link shared payment token, the default) or by stablecoin (USDC on Tempo): set method. The first call returns a payment challenge (JSON-RPC error -32042). Pay it and call again with the credential in _meta. With no API key, a new workspace is created and its API key is returned once: store it and send it as Authorization: Bearer . With an API key or a signed-in account, the credits are added to that workspace. The first card or Link purchase from each payer gets 50% bonus credits.

Inputs: pack (required), method. Returns: apiKey, status, balance, serverUrl, +2 more

find_nyc_propertyFind an NYC propertyA
Read-onlyIdempotent
Inspect

Free. Finds New York City tax lots by address, e.g. "40 Water Street Manhattan". Returns each match's BBL for get_nyc_property. NYC only; for other US properties use the national property tools.

Inputs: query (required). Returns: results

get_credit_balanceGet credit balanceA
Read-onlyIdempotent
Inspect

Shows the credit balance of the user's workspace, credits spent today, and recent charges. Free; never spends credits. Use it when the user asks about credits, or before a search that would cost more than the balance.

Inputs: no named parameters. Returns: balance, spentToday, recentCharges

get_hercules_overviewGet the Hercules overviewA
Read-onlyIdempotent
Inspect

Free, no sign-in. Describes Hercules: what it covers (every NYC tax lot, NYC pre-foreclosures, nationwide US property records, LLC owners and investors), every tool and whether it spends credits, plan and credit prices, and how to connect an account. Call it first when the user asks what Hercules can do or what it costs.

Inputs: no named parameters. Returns: links, plans, tools, coverage, +2 more

get_nyc_owner_portfolioGet an NYC owner's buildingsA
Read-onlyIdempotent
Inspect

Free. Lists the NYC buildings linked to a person from search_nyc_owners, and whether each is held as the owner of record or through a company. The full list is on the Platinum plan; other plans see the first few buildings.

Inputs: personKey (required), cursor. Returns: full, total, buildings, nextCursor

get_nyc_preforeclosure_detailGet NYC preforeclosure recordAInspect

Spends 1 credit, unless this workspace already pulled the record, then free. Returns the full record for one NYC preforeclosure: case and index number, stage, lender, amounts owed and due, mortgage, owner of record and building facts. NYC preforeclosures only; take the id from search_nyc_preforeclosures. Tell the user it costs 1 credit before calling.

Inputs: id (required). Returns: balance, property, alreadyOwned, creditsCharged

get_nyc_propertyGet an NYC propertyA
Read-onlyIdempotent
Inspect

Free. Returns the public facts for one NYC lot (building, lot, units, year built, last sale) and the owner of record from the city lot file. Also says whether the full report is already unlocked for this workspace and what unlock_nyc_property_report and unlock_nyc_owner_contacts cost. When the report is already unlocked it is returned in full.

Inputs: bbl (required). Returns: facts, report, balance, recordOwner, +4 more

get_nyc_unitGet one NYC condo unit or co-op apartmentA
Read-onlyIdempotent
Inspect

Free. Reads one unit inside an NYC building: a condominium unit (its own tax lot) or a co-op apartment (shares, valued here by an estimate from recent sales in its line). Pass the building lot from find_nyc_property and the unit as the person wrote it, e.g. "14E", "Apt 1C" or "#PH-A". Use it whenever the person names a unit, apartment or penthouse; the building lot alone describes the whole building, not the unit.

Inputs: bbl (required), unit. Returns: unit, found, knownUnits

get_property_detailGet a property recordAInspect

Spends 2 credits, unless this workspace pulled the same property in the last 7 days, then free. Returns the full record for one property from a national search: owners of record, building and lot, value and equity, open mortgages and lenders, foreclosure filings and last sale. Take property_id (it starts with "prop_") from run_national_property_search or run_active_investor_search. Tell the user it costs 2 credits and get their go-ahead before calling. For NYC preforeclosures use get_nyc_preforeclosure_detail instead.

Inputs: property_id (required). Returns: id, apn, owners, vacant, +24 more

quote_llc_owner_lookupQuote an LLC owner lookupA
Read-onlyIdempotent
Inspect

Use to find who is behind an LLC or company, for example the LLC that owns a property: its officers or managers, registered agent and formation details from public business records. Free: this tool only returns a quote and never spends credits. The quote states the credit cost (charged only if the company is found) and what that state's public records show; some states list the company but not its officers. Tell the user the cost and that note, and ask. Only after the user agrees, call run_llc_owner_lookup with the quote_id. Pass the company's exact registered name and the state where it is registered.

Inputs: state (required), entityName (required). Returns: kind, balance, credits, quoteId, +9 more

run_llc_owner_lookupRun an LLC owner lookupAInspect

Spends credits. Runs a quote from quote_llc_owner_lookup and returns the company's officers or managers, registered agent and formation details. Charges only if the company is found, never more than the quote. A company that is not found costs nothing. Call only after the user agreed to the quoted cost. A quote runs once and expires after 10 minutes.

Inputs: quote_id (required). Returns: balance, company, quoteId, alreadyOwned, +1 more

search_nyc_ownersSearch NYC owners by nameA
Read-onlyIdempotent
Inspect

Free. Finds people who own or control NYC buildings, by name, directly or through companies. Returns each person's key, building count and boroughs. Use get_nyc_owner_portfolio with the key to list their buildings.

Inputs: name (required), includeManagers. Returns: people, approximate

search_nyc_preforeclosuresSearch NYC preforeclosuresA
Read-onlyIdempotent
Inspect

Searches NYC properties in preforeclosure only: lis pendens foreclosure filings in Manhattan, Brooklyn, Queens, the Bronx and Staten Island. For one NYC property by address use find_nyc_property; for filtered searches or properties outside NYC use the national property search tools. Filters: borough, foreclosure stage, equity (1-3 family homes only), case age, recently added and amount owed. Returns summary rows, newest first, up to 25 per call (default 10); page with offset. Each row carries the lot's bbl when known. For the owner's phone and email on a row, call get_nyc_property with that bbl, then unlock_nyc_owner_contacts; never search the web for it. Never spends credits. On any paid plan the first 25 summary rows each day are free; other workspaces pay for every row. Rows the workspace already pulled are free again. Past the free rows, rows cost 1 credit per 10, and this tool returns them as a quote instead: tell the user the credit cost and ask before calling run_nyc_preforeclosure_search with the quote_id.

Inputs: limit, stage, equity, offset, +5 more. Returns: rows, quote, offset, totalMatches, +3 more

search_nyc_propertiesSearch NYC properties and unitsA
Read-onlyIdempotent
Inspect

Free. Never spends credits. Lists NYC lots, condo units and co-op apartments that match building, sale, value, equity and owner filters, 20 rows per page. For condo or co-op owners, set filters.grain to unit (it is set for you when the asset classes are only condo and co-op): each condo or co-op row is then one condo unit or co-op apartment with its own last sale, estimated value, equity and owner, and names its building. When the person asks for the buildings, set grain to lot. Estimated value (estValueMin, estValueMax) is a sale-based estimate from comparable sales; always say estimated. The city's market value is never shown or filtered. On lots, equity is estimated for 1-3 family homes only. A co-op apartment with no open share loan has 100% equity; with an open share loan its equity is unknown and it never matches an equity filter. ownerBuildingsMin and ownerBuildingsMax count the owner's properties, buildings and units together. Filters the user's plan does not include are left off and named in the result. For one unit's details, call get_nyc_unit with the building BBL and the unit.

Inputs: zips, cursor, filters, boroughs. Returns: rows, grain, total, leftOff, +2 more

search_nyc_signalsSearch NYC property signalsA
Read-onlyIdempotent
Inspect

Lists NYC lots that carry one or more property signals: reasons a deal can happen, such as a loan coming due, an old mortgage not refinanced, a long-time owner, an absentee or company owner, a foreclosure case, the tax lien sale list, open code violations, a vacate order, unused air rights, a teardown lot or a rezoning. Use it for asks like these, with these keys: loans coming due or maturing: loan_maturing; old mortgage, not refinanced: aging_mortgage; long holds or long-time owners: long_hold; likely or motivated sellers: long_hold, absentee_owner, serial_seller, value_below_loan; tired landlords or distressed owners: code_violations, hpd_litigation, tax_lien, vacate_order; underwater or over-leveraged: value_below_loan; free and clear, no mortgage: no_recorded_debt; development sites or air rights: underbuilt, teardown, vacant_land, assemblage; new construction or rezonings: new_building_permit, rezoning_filed, entitled_not_built; recent sales or active buyers: just_sold, serial_buyer. Narrow by boroughs, ZIP codes, neighborhoods (ntas) and building types. Each row gives the BBL, address, owner of record and every signal on the lot with its date. Signals marked likely are estimates; say likely when you repeat them. The result also counts lots per signal in the area. Never spends credits. On any paid plan the first 25 rows each day are free; other workspaces pay for every row. Rows already pulled are free again. Past the free rows, rows cost 1 credit per row, and this tool returns them as a quote: tell the user the credit cost and ask before calling run_nyc_signals_search with the quote_id. No contacts in the result: use unlock_nyc_property_report and then unlock_nyc_owner_contacts on a BBL for the owner's phones and emails. Up to 50 rows per call (default 25), newest signal first; page with offset.

Inputs: signals (required), ntas, zips, limit, +4 more. Returns: rows, quote, counts, offset, +6 more

search_nyc_underused_propertiesSearch NYC underused buildingsA
Read-onlyIdempotent
Inspect

Lists NYC buildings with unused or vacant space: office buildings, school buildings and religious property (churches, convents, synagogues) in any of the five boroughs. A building is flagged when its owner reports it half occupied or less, half or more of its storefronts are reported vacant, it is listed for lease, a city order to vacate it is in force, or it is a school building with no school registered in it. Buildings listed for sale are returned too. Each row gives the BBL, address, owner of record, building size and every figure behind the flag, marked owner-reported, seen or inferred, with its date. The underused flag itself is derived. Never spends credits. On any paid plan the first 25 rows each day are free; other workspaces pay for every row. Rows already pulled are free again. Past the free rows, rows cost 1 credit per row, and this tool returns them as a quote: tell the user the credit cost and ask before calling run_nyc_underused_search with the quote_id. No contacts in the result: use unlock_nyc_property_report and then unlock_nyc_owner_contacts on a BBL for the owner's phones and emails. Up to 50 rows per call (default 25), largest buildings first; page with offset.

Inputs: use, ntas, zips, limit, +4 more. Returns: rows, quote, offset, totalMatches, +4 more

top_up_creditsTop up credits on the saved cardAInspect

Buys a credit pack on the workspace's saved card, the card it already paid Hercules with. There is no checkout page. Packs: 200 credits for $24.99; 550 credits for $59.99; 1500 credits for $149.99. Before you call it, confirm the pack and the price with the user, unless the user already told you to top up or to keep credits topped up. It charges only when an owner or admin allowed AI top-ups, and only up to the workspace's monthly cap. When AI top-ups are not allowed yet, it charges nothing and returns a one-click approval link for the user. When no card is saved, it charges nothing and returns a link where the user can buy the pack once.

Inputs: credits (required). Returns: status, balance, credits, currency, +5 more

unlock_nyc_owner_contactsUnlock NYC owner contactsAInspect

Spends credits: the contacts price from get_nyc_property (usually 3 credits). Takes only the lot's BBL, including a condo unit's BBL from get_nyc_unit; for a unit whose report is locked it first unlocks the unit report (its report price, usually 1 credit), so quote both. Returns how to reach the party in control of that lot: a name, phone numbers (with line type and do-not-call flag) and email addresses, the contact's role (owner, principal, permit filer, owner's representative or office line), the date the contact was found and the newest recorded deed, lease or transfer. When a recorded deed, lease or transfer names a newer party than the city tax roll, that party is the one looked up. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Credits are charged when a contact is returned, whatever its role; a miss costs nothing. When an unlocked contact is marked stale (a deed, lease or transfer was recorded after it was found, or it is old), call again with refresh: true to look it up again at the normal price; without refresh a repeat call is always free. Tell the user the cost and get their go-ahead before calling.

Inputs: bbl (required), refresh. Returns: bbl, stale, state, emails, +6 more

unlock_nyc_property_reportUnlock an NYC property reportAInspect

Spends credits: the report price from get_nyc_property (usually 1 credit). Free if this workspace unlocked the same lot in the last year. Returns the full NYC property report: owners and mailing address, deed and mortgage history, sales, DOB permits, HPD/DOB/ECB violations, tax bills and assessments, zoning and FAR with unused air rights, HPD registration contacts, pre-foreclosure case and tax-lien flags. Tell the user the cost and get their go-ahead before calling.

Inputs: bbl (required). Returns: facts, report, balance, creditsCharged

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query NYC public records through a hosted MCP server, supporting civic workflows such as property research, business evaluation, public money tracking, and influence mapping.
      10 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides access to comprehensive US property data, including automated valuations, tax history, comparable sales, and ownership details, enabling real estate analysis and market insights.
      90 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides free property and parcel intelligence using official US government data APIs, county assessor records, and live listings, with tools for hazard risk checks, affordability calculations, and parcel ranking.
      1
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources