Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "property-data": {
      "type": "http",
      "url": "https://app.hercules.properties/mcp"
    }
  }
}

claude mcp add --transport http property-data https://app.hercules.properties/mcp

[mcp_servers.property-data]
url = "https://app.hercules.properties/mcp"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "property-data": {
      "type": "remote",
      "url": "https://app.hercules.properties/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "property-data": {
      "type": "http",
      "url": "https://app.hercules.properties/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=property-data&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBwLmhlcmN1bGVzLnByb3BlcnRpZXMvbWNwIn0%3D"
}

{
  "servers": {
    "property-data": {
      "type": "http",
      "url": "https://app.hercules.properties/mcp"
    }
  }
}

{
  "mcpServers": {
    "property-data": {
      "httpUrl": "https://app.hercules.properties/mcp"
    }
  }
}

extensions:
  "property-data":
    enabled: true
    name: "property-data"
    type: streamable_http
    uri: "https://app.hercules.properties/mcp"
    timeout: 300

Quality 83 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
warn
tools.description_length3 tools have descriptions over 1,024 characters, which crowds the context
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations25 of 25 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 7,960 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability75 · weight 15

warn
stability.changes26 tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

25 tools, about 7,960 tokens to load them all · tool set b319e6df401a · tools last changed 2026-10-19 · checked 2026-10-20 10:03 UTC

Tool changes

2026-10-19top_up_creditsadded
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.
2026-10-19unlock_nyc_owner_contactschangeddescription, input schema, output schema
before
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 owner of record of that lot about the property: the owner's name, phone numbers (with line type and do-not-call flag) and email addresses. When the owner of record is a company, the contact is the company's principal. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Tell the user the cost and get their go-ahead before calling.
after · 60% of words in common
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.
2026-10-17unlock_nyc_owner_contactschangeddescription
before
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 owner of record of that lot about the property: the owner's name, phone numbers (with line type and do-not-call flag) and email addresses. When the owner of record is a company, the contact is the company's principal. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Tell the user the cost and get their go-ahead before calling. Respect do-not-call flags.
after · 98% of words in common
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 owner of record of that lot about the property: the owner's name, phone numbers (with line type and do-not-call flag) and email addresses. When the owner of record is a company, the contact is the company's principal. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Tell the user the cost and get their go-ahead before calling.
2026-10-17quote_national_property_searchchangedinput schema
2026-10-17get_nyc_preforeclosure_detailchangedoutput schema
2026-10-17run_nyc_preforeclosure_searchchangedoutput schema
2026-10-17search_nyc_preforeclosureschangedoutput schema
2026-10-17get_nyc_unitadded
Free. Reads one unit inside an NYC building: a condominium unit (its own tax lot, with its own market value) 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.
2026-10-17unlock_nyc_owner_contactschangeddescription
before
Spends credits: the contacts price from get_nyc_property (usually 3 credits). Takes only the lot's BBL. Returns how to reach the owner of record of that lot about the property: the owner's name, phone numbers (with line type and do-not-call flag) and email addresses. When the owner of record is a company, the contact is the company's principal. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Tell the user the cost and get their go-ahead before calling. Respect do-not-call flags.
after · 84% of words in common
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 owner of record of that lot about the property: the owner's name, phone numbers (with line type and do-not-call flag) and email addresses. When the owner of record is a company, the contact is the company's principal. Needs the full report unlocked first (unlock_nyc_property_report). Free if already unlocked for this workspace. Tell the user the cost and get their go-ahead before calling. Respect do-not-call flags.
2026-10-17search_nyc_preforeclosureschangeddescription
before
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, case age, recently added, market value and amount owed. Returns summary rows, newest first, up to 25 per call (default 10); page with offset. 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.
after · 86% of words in common
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, case age, recently added, market value 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.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 82 / 100

no-repository

provenance55

liveness98

freshness100

hygiene80

+dns-namespace +website +reachable +uptime-96% +updated-13d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://app.hercules.properties/mcp` streamable-http	none	yes	96%	594 ms	2025-11-25	2026-10-20

Tools (25)

`buy_credits`	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.
`find_nyc_property`read-only	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.
`get_credit_balance`read-only	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.
`get_hercules_overview`read-only	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.
`get_nyc_owner_portfolio`read-only	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.
`get_nyc_preforeclosure_detail`	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.
`get_nyc_property`read-only	Free. Returns the public facts for one NYC lot (building, lot, units, year built, city market value, 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.
`get_nyc_unit`read-only	Free. Reads one unit inside an NYC building: a condominium unit (its own tax lot, with its own market value) 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.
`get_property_detail`	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.
`quote_active_investor_search`read-only	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.
`quote_investor_firm_search`read-only	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.
`quote_llc_owner_lookup`read-only	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.
`quote_national_property_search`read-only	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.
`run_active_investor_search`	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.
`run_investor_firm_search`	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.
`run_llc_owner_lookup`	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.
`run_national_property_search`	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.
`run_nyc_preforeclosure_search`	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.
`run_nyc_underused_search`	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.
`search_nyc_owners`read-only	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.
`search_nyc_preforeclosures`read-only	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, case age, recently added, market value 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.
`search_nyc_underused_properties`read-only	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.
`top_up_credits`	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.
`unlock_nyc_owner_contacts`	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.
`unlock_nyc_property_report`	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "properties.hercules/property-data",
  "title": "Hercules property data",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://app.hercules.properties/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.0",
  "websiteUrl": "https://hercules.properties/integrations/mcp",
  "description": "NYC and US property records: owners, LLC officers, mortgages, pre-foreclosures and investors."
}