Server URL
https://app.hercules.properties/mcp
Streamable HTTP with OAuth sign-in. Your assistant opens a Hercules sign-in page the first time; no API key to copy.
Connect your assistant
Claude
- Open Settings, then Connectors, and choose Add custom connector.
- Paste the server URL and choose Add.
- Choose Connect and sign in to Hercules.
ChatGPT
- Open Settings, then Apps, and add a custom app with the server URL.
- Sign in to Hercules when ChatGPT asks.
Claude Code
- Run this command, then run /mcp in Claude Code and sign in.
claude mcp add --transport http hercules https://app.hercules.properties/mcp
Cursor
- Add this server to ~/.cursor/mcp.json, then sign in from Cursor's MCP settings.
{
"mcpServers": {
"hercules": {
"url": "https://app.hercules.properties/mcp"
}
}
}
What it can do
NYC properties and owners
| Tool | What it does | Cost |
|---|
| find_nyc_property | Turns an NYC street address into the lot's BBL. | Free |
| get_nyc_property | Returns the lot's public facts and owner of record, and what the full report and owner contacts cost. | Free |
| unlock_nyc_property_report | Returns the full report: owners and mailing address, deeds and mortgages, sales, permits, violations, tax, zoning and FAR, pre-foreclosure. | Credits |
| unlock_nyc_owner_contacts | Returns phone numbers, with do-not-call flags, and emails for the owner of record, or a company owner's principal. | Credits |
| search_nyc_owners | Finds people who own or control NYC buildings, by name. | Free |
| get_nyc_owner_portfolio | Lists the buildings linked to an owner, held directly or through a company. Full list on Platinum. | Free |
NYC pre-foreclosures
| Tool | What it does | Cost |
|---|
| search_nyc_preforeclosures | Searches open NYC foreclosure cases by borough, stage, equity, case age and value. Returns a quote when rows cost credits. | Free |
| run_nyc_preforeclosure_search | Returns the rows from a quote, for the quoted credits and never more. | Credits |
| get_nyc_preforeclosure_detail | Returns one full case: stage, amounts owed, lender, mortgage, owner of record and building facts. | Credits |
Property records across the US
| Tool | What it does | Cost |
|---|
| quote_national_property_search | Quotes a search of US property records by place, property type, value, equity, distress and owner filters. | Free |
| run_national_property_search | Returns the property records from a quote. | Credits |
| get_property_detail | Returns the full record for one property: owners of record, building and lot, value and equity, open mortgages, foreclosure filings and last sale. | Credits |
Owners, investors and companies
| Tool | What it does | Cost |
|---|
| quote_active_investor_search | Quotes a search for investors actively buying in a ZIP code, city or county. | Free |
| run_active_investor_search | Returns those investors grouped by owner, with portfolio size and purchases in the last 12 months. | Credits |
| quote_llc_owner_lookup | Quotes a lookup of the people behind an LLC or company from public business records. | Free |
| run_llc_owner_lookup | Returns officers or managers, registered agent and formation details. A company that is not found costs nothing. | Credits |
| quote_investor_firm_search | Quotes a search for investor and lender firms in a state or city: hard-money and private lenders, funds, cash buyers and wholesalers. | Free |
| run_investor_firm_search | Returns those firms with business phone, business email, website and key people. | Credits |
Getting started and your account
| Tool | What it does | Cost |
|---|
| get_hercules_overview | Describes coverage, every tool, prices and how to connect. Works before sign-in. | Free |
| buy_credits | Buys a credit pack by card (Stripe Link) or stablecoin with no account; returns an API key. Also at POST /api/agent/credits. | Card or stablecoin |
| get_credit_balance | Shows the workspace credit balance, today's spend, the daily limit and recent charges. | Free |
Cost
- Searches and quotes are free. Tools that return records spend your workspace's credits, never more than the quote.
- The assistant tells you the cost and waits for your go-ahead before it spends anything. A daily spending limit applies.
- A new account starts with 1 report credit. Plans and credit packs are on the pricing page.
Example questions
- Find Brooklyn pre-foreclosures with high equity filed this year.
- Who is behind the LLC that owns this building?
- Which investors bought two or more homes in 11207 last year?
- List hard-money lenders in New Jersey.
See product facts for coverage and prices.