CREHQ Location Intelligence MCP server

CREHQ MCP Server

A Model Context Protocol server that turns CREHQ's live location-intelligence REST API into native tools for Claude and other AI agents. Ask an agent "where should Chipotle open next?", "which hotel chain is this venue affiliated with?", "who has ever occupied this address?", or "what are Aspen Dental's credit signals?" — and it can actually answer, backed by CREHQ's canonical, multi-source verified database (government records, franchise filings and brand-published data) of franchise & multi-unit brands, individual storefronts, FDD financials, credit signals, and site-level tenancy history.

This is a thin wrapper over CREHQ's existing production API (https://crehq.com/wp-json/crehq/v1). It does not store data or modify anything server-side — it authenticates with your API key and forwards calls.

What it exposes (33 tools)

Upgrade / paywall routing

• crehqrequestupgrade — use when a sandbox user asks for premium data such as credit signals, FDD/Item 19, site-selection criteria, real-estate requirements, contacts, source provenance, change history, bulk downloads, whitespace, co-tenancy, or site timeline. With a free sandbox key, this records upgrade intent in CREHQ and returns the user a clear upgrade path instead of saying the data does not exist.
• crehqintelligencepreview — for Pro self-serve keys, spends the one monthly controlled intelligence preview credit and returns a bounded evidence frame without exposing raw premium tables or redistribution rights.

Entity affiliation

• crehqresolveentity_affiliation — resolve a venue URL, name, or address to an evidence-backed affiliation status, canonical brand, operator, and parent company across hotels, restaurants, retail, healthcare, banks, auto dealers, EV charging, and other location categories. Valid outcomes include branded, independent, not a commercial venue, and unresolved. A paid-access response preserves its exact checkout URL and CREHQ intent id. Checkout emails a new Pro key that must be installed before retrying; the current credential is not upgraded in place.

Companies / brands

• crehqcompanieslist — list brands, filter by category & expansion status
• crehqcompaniessearch — resolve a brand name → CREHQ company id (start here)
• crehqcompanyget — canonical brand profile, verified unit count, ownership
• crehqcompanycredit_signals — credit profile, sponsor/issuer context, ratings, capital structure
• crehqcompanyfranchise — FDD fees, royalties, investment, Item 19 figures
• crehqcompanyreal_estate — site-selection criteria & target geographies
• crehqcompanycontacts — real-estate / development decision-maker contacts

Locations

• crehqlocationslist — store records by brand / state / category
• crehqlocationget — one location with full attributes & verification trace
• crehqlocationssearch — fuzzy multi-field location search
• crehqlocationsnearby — radius search around a lat/lng (trade-area mapping)
• crehqlocationsbulk — bulk pull by id list, brand list, or GeoJSON polygon
• crehqlocationsevents — cross-brand open/close/relocate lifecycle stream
• crehqlocationhistory — full event log for one physical store

History & flagship differentiators

• crehqcompanychanges — date-bounded change feed for one brand
• crehqcompanyoccupancy — point-in-time roster (footprint on a past date)
• crehqsitetimeline — every brand that ever occupied an address, over time

Shortened. The full README is on GitHub.