Hercules MCP server Use Hercules property research inside Claude, ChatGPT, Cursor or any assistant that speaks the Model Context Protocol. Ask in plain language; the assistant searches, quotes the cost and asks before it spends a credit.
Connect your assistant to Hercules Create a free account, then sign in from Claude, ChatGPT or Cursor. New accounts get 1 report credit; plans add monthly credits.
Server URL https://app.hercules.properties/mcpStreamable 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/mcpCursor 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 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 person behind the owner of record. 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 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 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 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 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 sources.