properties.hercules/property-data

Est-ce que properties.hercules/property-data est sûr ?

Au dernier audit MCP Hub, le serveur MCP « properties.hercules/property-data » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 25 outils

• buy_credits≈ 500 tokens

  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 <key>. 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.

  Paramètres, retour & exemple (2)

  Paramètres

  • pack · string · requis
    Which pack to buy: starter_80 (80 credits, $9.99), pack_200 (200 credits, $24.99), pack_550 (550 credits, $59.99), pack_1500 (1500 credits, $149.99).
  • method · string · optionnel · card | stablecoin
    How to pay: card (Stripe Link shared payment token, the default) or stablecoin (USDC on Tempo).

  Exemple d'appel

  {"name": "buy_credits", "arguments": {"pack": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"apiKey": "texte", "status": "provisioned", "balance": "texte", "serverUrl": "texte", "bonusCredits": 1, "creditsAdded": 1}}

• find_nyc_property≈ 268 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • query · string · requis
    An NYC street address.

  Exemple d'appel

  {"name": "find_nyc_property", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"results": []}}

• get_credit_balance≈ 242 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_credit_balance", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"balance": 1, "spentToday": 1, "recentCharges": []}}

• get_hercules_overview≈ 436 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_hercules_overview", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"links": {}, "plans": [], "tools": [], "coverage": [], "serverUrl": "texte", "creditPacks": []}}

• get_nyc_owner_portfolio≈ 460 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • cursor · ? · optionnel
  • personKey · string · requis

  Exemple d'appel

  {"name": "get_nyc_owner_portfolio", "arguments": {"personKey": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"full": true, "total": 1, "buildings": [], "nextCursor": "texte"}}

• get_nyc_preforeclosure_detail≈ 868 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    The id of a row from search_nyc_preforeclosures.

  Exemple d'appel

  {"name": "get_nyc_preforeclosure_detail", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"balance": 1, "property": {}, "alreadyOwned": true, "creditsCharged": 1}}

• get_nyc_property≈ 4464 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • bbl · string · requis
    The 10-digit NYC borough-block-lot id, e.g. "1000300034". Get it from find_nyc_property.

  Exemple d'appel

  {"name": "get_nyc_property", "arguments": {"bbl": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"facts": {}, "report": "texte", "balance": 1, "recordOwner": "texte", "reportPrice": 1, "contactsPrice": 1, "contactsState": "texte", "reportUnlocked": true}}

• get_nyc_unit≈ 854 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • bbl · string · requis
    The building's 10-digit lot (BBL) from find_nyc_property.
  • unit · string · optionnel
    Leave out to list the building's units.

  Exemple d'appel

  {"name": "get_nyc_unit", "arguments": {"bbl": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"unit": "texte", "found": true, "knownUnits": []}}

• get_property_detail≈ 1074 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • property_id · string · requis
    A property id from a national search result, e.g. prop_123456.

  Exemple d'appel

  {"name": "get_property_detail", "arguments": {"property_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"id": "texte", "apn": "texte", "owners": [], "vacant": "texte", "zoning": "texte", "address": "texte", "balance": 1, "bedrooms": "texte", "bathrooms": "texte", "mortgages": [], "yearBuilt": "texte", "highEquity": "texte"}}

• quote_active_investor_search≈ 1354 tokens

  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.

  Paramètres, retour & exemple (13)

  Paramètres

  • zip · ? · optionnel
    Five-digit zip code. The narrowest and cheapest place filter.
  • city · ? · optionnel
    City name.
  • limit · ? · optionnel
    Records to price in this batch (max 250). Leave empty to let the quote pick a safe batch size.
  • state · string · requis
    Two-letter state code, e.g. TX. Required.
  • county · ? · optionnel
    County name, without the word County.
  • offset · integer · optionnel
    Skip this many matches. Use it to quote the next page.
  • propertyType · ? · optionnel
    SFR single family, MFR multifamily, CONDO, LAND, MOBILE or OTHER.
  • corporateOnly · boolean · optionnel
    Only companies and LLCs.
  • outOfStateOnly · boolean · optionnel
    Only owners whose mailing address is in another state.
  • cashInvestorOnly · boolean · optionnel
    Only properties bought with cash by an absentee investor.
  • boughtWithinMonths · ? · optionnel
    Only properties in this area bought in the last N months. Default 12. Null means any time.
  • minPropertiesOwned · ? · optionnel
    Only owners with at least this many properties. Default 2.
  • minPurchasesLast12Months · ? · optionnel
    Only owners who bought at least this many properties in the last 12 months, counted across their whole portfolio.

  Exemple d'appel

  {"name": "quote_active_investor_search", "arguments": {"state": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"offset": 1, "balance": 1, "credits": 1, "quoteId": "texte", "runTool": "texte", "expiresAt": "texte", "affordable": true, "suggestions": [], "balanceAfter": 1, "ownedInBatch": 1, "totalMatches": 1, "recommendation": "run"}}

• quote_investor_firm_search≈ 744 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • city · string · optionnel
    City to search in. Leave out to search the whole state.
  • state · string · requis · AL | AK | AZ | AR | CA | CO | CT | DE
    Two-letter US state, e.g. TX.
  • maxResults · integer · optionnel
    Most firms to return, 1-25. Default 10.
  • investorType · string · requis · hard_money_lender | private_lender | note_buyer | fix_and_flip | real_estate_fund | cash_home_buyer | wholesaler
    The kind of firm: hard_money_lender (hard-money lenders), private_lender (private money lenders), note_buyer (mortgage note buyers), fix_and_flip (fix-and-flip investors), real_estate_fund (real estate investment funds), cash_home_buyer (cash home buyers), wholesaler (real estate wholesalers).

  Exemple d'appel

  {"name": "quote_investor_firm_search", "arguments": {"state": "AL", "investorType": "hard_money_lender"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"kind": "llc", "balance": 1, "credits": 1, "quoteId": "texte", "runTool": "texte", "coverage": "texte", "expiresAt": "texte", "affordable": true, "maxResults": 1, "alreadyOwned": true, "balanceAfter": 1, "coverageNote": "texte"}}

• quote_llc_owner_lookup≈ 608 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • state · string · requis · AL | AK | AZ | AR | CA | CO | CT | DE
    Two-letter US state where the company is registered, e.g. FL. Often the state of the property.
  • entityName · string · requis
    The company's registered name, as on the deed or tax record, e.g. "Sunrise Holdings LLC".

  Exemple d'appel

  {"name": "quote_llc_owner_lookup", "arguments": {"state": "AL", "entityName": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"kind": "llc", "balance": 1, "credits": 1, "quoteId": "texte", "runTool": "texte", "coverage": "texte", "expiresAt": "texte", "affordable": true, "maxResults": 1, "alreadyOwned": true, "balanceAfter": 1, "coverageNote": "texte"}}

• quote_national_property_search≈ 1604 tokens

  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.

  Paramètres, retour & exemple (21)

  Paramètres

  • zip · ? · optionnel
    Five-digit zip code. The narrowest and cheapest place filter.
  • city · ? · optionnel
    City name.
  • flags · array · optionnel
    Only properties with all of these: pre_foreclosure, foreclosure, auction, reo (bank-owned), vacant, absentee_owner, high_equity, free_clear (no mortgage), inherited, death (owner deceased, a probate signal), judgment (judgment lien), tax_lien, mls_cancelled (listing cancelled or expired, a failed sale), negative_equity.
  • limit · ? · optionnel
    Records to price in this batch (max 250). Leave empty to let the quote pick a safe batch size.
  • state · string · requis
    Two-letter state code, e.g. TX. Required.
  • county · ? · optionnel
    County name, without the word County.
  • offset · integer · optionnel
    Skip this many matches. Use it to quote the next page.
  • bedsMin · ? · optionnel
  • bathsMin · ? · optionnel
  • valueMax · ? · optionnel
  • valueMin · ? · optionnel
  • cashBuyer · boolean · optionnel
    Only properties bought with cash.
  • propertyType · ? · optionnel
    SFR single family, MFR multifamily, CONDO, LAND, MOBILE or OTHER.
  • yearBuiltMax · ? · optionnel
  • yearBuiltMin · ? · optionnel
  • lastSoldAfter · ? · optionnel
    Last sale on or after this date.
  • corporateOwned · boolean · optionnel
    Only properties owned by a company or LLC.
  • lastSoldBefore · ? · optionnel
    Last sale on or before this date.
  • outOfStateOwner · boolean · optionnel
    Only owners whose mailing address is in another state.
  • equityPercentMin · ? · optionnel
    Minimum estimated equity, in percent.
  • ownerPropertiesMin · ? · optionnel
    Only owners who own at least this many properties.

  Exemple d'appel

  {"name": "quote_national_property_search", "arguments": {"state": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"offset": 1, "balance": 1, "credits": 1, "quoteId": "texte", "runTool": "texte", "expiresAt": "texte", "affordable": true, "suggestions": [], "balanceAfter": 1, "ownedInBatch": 1, "totalMatches": 1, "recommendation": "run"}}

• run_active_investor_search≈ 956 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quoteId returned by quote_active_investor_search.

  Exemple d'appel

  {"name": "run_active_investor_search", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "balance": 1, "charged": 1, "quoteId": "texte", "released": 1, "investors": []}}

• run_investor_firm_search≈ 517 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quoteId from quote_investor_firm_search.

  Exemple d'appel

  {"name": "run_investor_firm_search", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"firms": [], "balance": 1, "quoteId": "texte", "alreadyOwned": true, "creditsCharged": 1}}

• run_llc_owner_lookup≈ 574 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quoteId from quote_llc_owner_lookup.

  Exemple d'appel

  {"name": "run_llc_owner_lookup", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"balance": 1, "company": "texte", "quoteId": "texte", "alreadyOwned": true, "creditsCharged": 1}}

• run_national_property_search≈ 782 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quoteId returned by quote_national_property_search.

  Exemple d'appel

  {"name": "run_national_property_search", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "balance": 1, "charged": 1, "quoteId": "texte", "released": 1}}

• run_nyc_preforeclosure_search≈ 595 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quote.quoteId from search_nyc_preforeclosures.

  Exemple d'appel

  {"name": "run_nyc_preforeclosure_search", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "offset": 1, "balance": 1, "quoteId": "texte", "totalMatches": 1, "creditsCharged": 1}}

• run_nyc_signals_search≈ 516 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quote.quoteId from search_nyc_signals.

  Exemple d'appel

  {"name": "run_nyc_signals_search", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "offset": 1, "balance": 1, "quoteId": "texte", "totalMatches": 1, "creditsCharged": 1, "possibleIsEstimate": true}}

• run_nyc_underused_search≈ 720 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • quote_id · string · requis
    The quote.quoteId from search_nyc_underused_properties.

  Exemple d'appel

  {"name": "run_nyc_underused_search", "arguments": {"quote_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "offset": 1, "balance": 1, "quoteId": "texte", "totalMatches": 1, "creditsCharged": 1, "underusedIsDerived": true}}

• search_nyc_owners≈ 360 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • name · string · requis
  • includeManagers · boolean · optionnel

  Exemple d'appel

  {"name": "search_nyc_owners", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"people": [], "approximate": true}}

• search_nyc_preforeclosures≈ 1292 tokens

  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.

  Paramètres, retour & exemple (9)

  Paramètres

  • limit · integer · optionnel
    Rows to return, 1 to 25. Defaults to 10.
  • stage · array · optionnel
    Foreclosure stages to include. Empty means every stage.
  • equity · array · optionnel
    Estimated equity: positive (value above the debt) or negative, known for 1-3 family homes only. Empty means any.
  • offset · integer · optionnel
    Rows to skip, for the next page.
  • borough · array · optionnel
    NYC boroughs to include. Empty means all five.
  • filingAge · array · optionnel
    Case age by filing year: fresh (under 2 years), seasoned (2 to 5), long_running (5 or more).
  • amountOwedMax · ? · optionnel
  • amountOwedMin · ? · optionnel
  • addedWithinDays · ? · optionnel
    Only filings added in the last N days. Use for 'new this week'.

  Exemple d'appel

  {"name": "search_nyc_preforeclosures", "arguments": {"limit": 1, "stage": [], "equity": [], "offset": 1, "borough": [], "filingAge": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "quote": "texte", "offset": 1, "totalMatches": 1, "creditsCharged": 1, "freeRowsPerDay": 1, "freeRowsUsedToday": 1}}

• search_nyc_properties≈ 3413 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • zips · array · optionnel
    NYC ZIP codes the person named.
  • cursor · string · optionnel
    nextCursor from the previous page.
  • filters · object · optionnel
    The same filters as the Hercules NYC map: assetClasses (condo, coop, one_two_family and more), sale price and dates, estValueMin and estValueMax, equityPctMin, ownerBuildingsMin and ownerBuildingsMax, ownedYearsMin, absenteeOwnerOnly, zips, ntas, signals and more. Leave out anything the person did not ask for.
  • boroughs · array · optionnel
    Whole NYC boroughs. For part of a borough use filters.ntas.

  Exemple d'appel

  {"name": "search_nyc_properties", "arguments": {"zips": [], "cursor": "texte", "filters": {}, "boroughs": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "grain": "lot", "total": 1, "leftOff": [], "nextCursor": "texte", "totalCapped": true}}

• search_nyc_signals≈ 1939 tokens

  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.

  Paramètres, retour & exemple (8)

  Paramètres

  • ntas · array · optionnel
    2020 neighborhood codes from find_nyc_area, for example BK0102 Williamsburg. Use them whenever the person names a neighborhood.
  • zips · array · optionnel
    NYC ZIP codes. Boroughs, ZIPs and ntas combine as any of them.
  • limit · integer · optionnel
  • match · string · optionnel · any | all
    any keeps lots with at least one of the signals; all keeps lots with every one.
  • offset · integer · optionnel
  • signals · array · requis
    One or more signal keys: long_hold, absentee_owner, entity_owner, portfolio_owner, just_sold, serial_buyer, serial_seller, recorded_mortgage, no_recorded_debt, aging_mortgage, value_below_loan, foreclosure_filed, auction_scheduled, tax_lien, code_violations, vacate_order, fire_vacate, hpd_litigation, vacant_storefront, underbuilt, vacant_land, teardown, land_just_bought, assemblage, rezoning_filed, new_building_permit, new_co, entitled_not_built, loan_maturing, io_balloon, weak_coverage, occupancy_down, noi_down, dscr_below_1, loan_modified, maturity_extended, servicer_advancing, special_servicing, delinquent, ll97_covered, ll97_fine_2024, ll97_fine_2030, evictions, facade_unsafe, j51_ending, 421a_ending, low_inspection_grade, lihtc_year15, subsidy_expiring, oz_year10.
  • boroughs · array · optionnel
    Whole NYC boroughs. All five when omitted.
  • asset_classes · array · optionnel
    Building types, for example multifamily_walkup, multifamily_elevator, mixed_use, office, retail, one_two_family, condo, coop.

  Exemple d'appel

  {"name": "search_nyc_signals", "arguments": {"signals": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "quote": "texte", "counts": [], "offset": 1, "notYetBuilt": [], "totalMatches": 1, "creditsCharged": 1, "freeRowsPerDay": 1, "freeRowsUsedToday": 1, "possibleIsEstimate": true}}

• search_nyc_underused_properties≈ 1446 tokens

  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.

  Paramètres, retour & exemple (8)

  Paramètres

  • use · string · optionnel · office | school | religious
    office (office buildings), school (school buildings) or religious (churches, convents, synagogues and other property of religious owners). Every use when omitted.
  • ntas · array · optionnel
    2020 neighborhood codes from find_nyc_area, for example MN0801 Upper East Side-Lenox Hill-Roosevelt Island. Use them whenever the person names a neighborhood, so rows outside it are never quoted.
  • zips · array · optionnel
    NYC ZIP codes. Combined with ntas as any of those places.
  • limit · integer · optionnel
  • offset · integer · optionnel
  • reason · string · optionnel · low_occupancy | vacant_storefronts | for_lease | for_sale | vacate_order | no_school
    Keep only buildings with this signal: low_occupancy (owner reports half or less occupied), vacant_storefronts (half or more vacant), for_lease, for_sale, vacate_order (a city order to vacate still in force), no_school (a school building with no school registered in it).
  • borough · string · optionnel · manhattan | bronx | brooklyn | queens | staten_island
    One NYC borough. All five when omitted.
  • min_building_sqft · integer · optionnel
    Smallest building area in square feet.

  Exemple d'appel

  {"name": "search_nyc_underused_properties", "arguments": {"use": "office", "ntas": [], "zips": [], "limit": 1, "offset": 1, "reason": "low_occupancy"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "quote": "texte", "offset": 1, "totalMatches": 1, "creditsCharged": 1, "freeRowsPerDay": 1, "freeRowsUsedToday": 1, "underusedIsDerived": true}}

• top_up_credits≈ 459 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • credits · integer · requis
    How many credits to buy. Must be one of the credit pack sizes.

  Exemple d'appel

  {"name": "top_up_credits", "arguments": {"credits": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"status": "purchased", "balance": "texte", "credits": 1, "currency": "texte", "expiresAt": "texte", "amountCents": 1, "approvalUrl": "texte", "monthlyCapCents": 1, "spentThisMonthCents": "texte"}}

• unlock_nyc_owner_contacts≈ 864 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • bbl · string · requis
    The 10-digit NYC borough-block-lot id, e.g. "1000300034". Get it from find_nyc_property.
  • refresh · boolean · optionnel
    Look a stale unlocked contact up again at the normal price. Ignored unless the contact is stale.

  Exemple d'appel

  {"name": "unlock_nyc_owner_contacts", "arguments": {"bbl": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"bbl": "texte", "stale": true, "state": "texte", "emails": [], "person": "texte", "phones": [], "balance": 1, "foundAt": "texte", "ownership": "texte", "creditsCharged": 1}}

• unlock_nyc_property_report≈ 4443 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • bbl · string · requis
    The 10-digit NYC borough-block-lot id, e.g. "1000300034". Get it from find_nyc_property.

  Exemple d'appel

  {"name": "unlock_nyc_property_report", "arguments": {"bbl": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"facts": {}, "report": "texte", "balance": 1, "creditsCharged": 1}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://app.hercules.properties/mcp