Hercules property data
Server Details
NYC and US property records: owners, LLC officers, mortgages, pre-foreclosures and investors.
- 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
Scored across 28 tools
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.
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.
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.
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 toolsbuy_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 propertyARead-onlyIdempotentInspect
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 balanceARead-onlyIdempotentInspect
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 overviewARead-onlyIdempotentInspect
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 buildingsARead-onlyIdempotentInspect
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 propertyARead-onlyIdempotentInspect
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 apartmentARead-onlyIdempotentInspect
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_active_investor_searchQuote an active investor searchARead-onlyIdempotentInspect
Finds who is actively buying in an area: properties in a zip, city or county owned by investors, grouped by owner when run. By default it looks for owners of 2+ properties who bought in this area in the last 12 months. Options: minPurchasesLast12Months keeps owners who bought at least N properties in the last 12 months. That count covers the owner's whole portfolio, not only this area, so it is the closest available measure of 'bought N+ here'; boughtWithinMonths keeps it to owners who bought here recently. corporateOnly keeps companies and LLCs. cashInvestorOnly keeps properties bought with cash by an absentee investor. outOfStateOnly keeps owners who live in another state. Each property record costs credits, the same as a national property search. Never spends credits: it counts the matches and prices one batch. Always quote first. Then tell the user the credit cost, the batch size and their balance after. Records this workspace already pulled in the last 24 hours are free. For large searches, prefer a smaller batch (limit) or narrower filters, such as a zip instead of a county. One run returns at most 250 records; page with offset. Quotes expire after 10 minutes. Call run_active_investor_search with the quote_id only after the user agrees to the credit cost.
Inputs: state (required), zip, city, limit, +9 more. Returns: offset, balance, credits, quoteId, +10 more
quote_investor_firm_searchQuote an investor firm searchARead-onlyIdempotentInspect
Use to find real estate investor and lender firms in a state or city: hard-money lenders, private money lenders, note buyers, fix-and-flip investors, investment funds, cash home buyers and wholesalers. Returns firms with business phones, business emails, website and key people (name and title only). Free: this tool only returns a quote and never spends credits. The quote states the cost per firm returned; firms not found cost nothing. Tell the user the cost and ask. Only after the user agrees, call run_investor_firm_search with the quote_id. To find who is actively buying properties in an area, use quote_active_investor_search instead.
Inputs: state (required), investorType (required), city, maxResults. Returns: kind, balance, credits, quoteId, +9 more
quote_llc_owner_lookupQuote an LLC owner lookupARead-onlyIdempotentInspect
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
quote_national_property_searchQuote a national property searchARead-onlyIdempotentInspect
Quotes a search of national property data: any US property, including NYC properties that are not in preforeclosure. Filters: place (state plus zip, city or county), property type, beds, baths, value, equity, year built, distress flags (preforeclosure, foreclosure, auction, bank-owned, vacant, absentee owner, high equity, free and clear, inherited) and owner filters (company-owned, out-of-state owner, cash buyer, owners of N+ properties, last sale dates). Never spends credits: it counts the matches and prices one batch. Always quote first. Then tell the user the credit cost, the batch size and their balance after. Records this workspace already pulled in the last 24 hours are free. For large searches, prefer a smaller batch (limit) or narrower filters, such as a zip instead of a county. One run returns at most 250 records; page with offset. Quotes expire after 10 minutes. Call run_national_property_search with the quote_id only after the user agrees to the credit cost.
Inputs: state (required), zip, city, flags, +17 more. Returns: offset, balance, credits, quoteId, +10 more
run_active_investor_searchRun a quoted active investor searchAInspect
Returns the investors and their properties from a quote made by quote_active_investor_search, grouped by owner with portfolio size and purchases in the last 12 months. Spends credits. Takes only a quote_id. Charges for the records returned, never more than the quote, and releases the rest. Before calling, the user must have agreed to the quoted credit cost. A quote runs once and expires after 10 minutes.
Inputs: quote_id (required). Returns: rows, balance, charged, quoteId, +2 more
run_investor_firm_searchRun an investor firm searchAInspect
Spends credits. Runs a quote from quote_investor_firm_search and returns the firms with business phones, business emails, website and key people (name and title only). Charges per firm returned, never more than the quote. No firms 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: firms, balance, quoteId, alreadyOwned, +1 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
run_national_property_searchRun a quoted national property searchAInspect
Returns the property records from a quote made by quote_national_property_search. Spends credits. Takes only a quote_id. Charges for the records returned, never more than the quote, and releases the rest. Before calling, the user must have agreed to the quoted credit cost. A quote runs once and expires after 10 minutes. Use get_property_detail on a record id for the full record.
Inputs: quote_id (required). Returns: rows, balance, charged, quoteId, +1 more
run_nyc_preforeclosure_searchGet quoted NYC preforeclosure rowsAInspect
Spends credits. Returns the NYC preforeclosure rows from a quote made by search_nyc_preforeclosures and charges the quoted credits (never more). Before calling, tell the user how many credits it costs and get their go-ahead. Quotes expire after 10 minutes and run once.
Inputs: quote_id (required). Returns: rows, offset, balance, quoteId, +2 more
run_nyc_signals_searchGet quoted NYC signal rowsAInspect
Spends credits. Returns the NYC signal rows from a quote made by search_nyc_signals and charges the quoted credits (never more). Before calling, tell the user how many credits it costs and get their go-ahead. Quotes expire after 10 minutes and run once.
Inputs: quote_id (required). Returns: rows, offset, balance, quoteId, +3 more
run_nyc_underused_searchGet quoted NYC underused buildingsAInspect
Spends credits. Returns the NYC underused-building rows from a quote made by search_nyc_underused_properties and charges the quoted credits (never more). Before calling, tell the user how many credits it costs and get their go-ahead. Quotes expire after 10 minutes and run once.
Inputs: quote_id (required). Returns: rows, offset, balance, quoteId, +3 more
search_nyc_ownersSearch NYC owners by nameARead-onlyIdempotentInspect
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 preforeclosuresARead-onlyIdempotentInspect
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 unitsARead-onlyIdempotentInspect
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 signalsARead-onlyIdempotentInspect
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 buildingsARead-onlyIdempotentInspect
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
Public records for any NYC property by address or BBL: permits, violations, sales, owners.
Agent-ready NYC public records. Hosted, source-backed civic data organized around durable anchors.
Building records for New York City and Jersey City: permits, taxes, tax breaks and zoning.
U.S. real-estate data: property records, AVM value + rent estimates, sale/rental listings.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables users to pierce anonymous real estate LLCs to resolve owner names, wireless phone numbers, and deliverable emails, enrich addresses with Census geocoding and GLEIF LEI data, and run OFAC SDN KYB compliance checks.MIT

Akil MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT- AlicenseNot gradedqualityCmaintenanceProvides access to comprehensive US property data, including automated valuations, tax history, comparable sales, and ownership details, enabling real estate analysis and market insights.90 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides 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-
Glama MCP Gateway
Add one secure layer between your agents and this server.