CREHQ Location Intelligence logo

CREHQ Location Intelligence

Connects AI agents to CREHQ’s location-intelligence API for brand, site, affiliation, dataset, and market analysis.

Install CREHQ Location Intelligence

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "crehq-location-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "crehq-mcp-server"
      ],
      "env": {
        "CREHQ_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

CREHQ Location Intelligence MCP server exposes CREHQ’s live REST API as MCP tools for researching brands, locations, affiliations, occupancy history, datasets, and market patterns. It authenticates with an API key and forwards requests to CREHQ without storing or modifying data. Use it for site selection, franchise and brand research, venue affiliation checks, location history, and licensed dataset access. Available results depend on the connected key’s Free, Pro, purchased-dataset, Intel, or Enterprise entitlements.

Use cases

  • Resolve a venue to its brand, operator, and parent company
  • Find nearby locations for trade-area analysis
  • Review a brand’s franchise, credit, and real-estate data
  • Trace which brands occupied an address over time
  • Compare whitespace, co-tenancy, and geographic trends

Key features

  • Brand and venue affiliation resolution
  • Location, radius, bulk, and polygon searches
  • Occupancy, tenancy, and lifecycle history
  • Franchise, credit, contacts, and real-estate data
  • Dataset and purchased-snapshot access
  • Whitespace, co-tenancy, and trend analysis

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · crehq-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads141Package downloads in the last 30 days.
Last commit15d agoMost recent push to the default branch.

How CREHQ Location Intelligence works

What CREHQ Location Intelligence MCP server does

CREHQ Location Intelligence MCP server connects MCP-compatible AI clients to CREHQ’s location-intelligence API. It covers multi-unit and franchise brands, storefronts, ownership, site-level tenancy, FDD information, credit signals, location events, and geographic trends. The connector is a thin API wrapper: it does not maintain its own database or change records in CREHQ.

The affiliation resolver can assess a venue URL, name, or address and return an evidence-backed status such as branded, independent, non-commercial, or unresolved. Where available, it identifies the canonical brand, operator, and parent company. Other tools support brand discovery, location searches, nearby-radius queries, bulk location retrieval, historical occupancy, and changes over time.

How it works

The server authenticates requests with a CREHQ API key and forwards them to the production REST base at https://crehq.com/wp-json/crehq/v1. It can run locally over MCP stdio or be accessed through CREHQ’s hosted MCP endpoint at https://mcp.crehq.com/mcp.

The catalog includes tools for companies, locations, affiliation, history, datasets, and trends. Premium operations include whitespace analysis, co-tenancy, modeled site profiles, observed site patterns, and recent location context. CREHQ’s backend applies the permissions and limits associated with the key. When a request is outside the key’s entitlement, the response can provide an upgrade or purchase path rather than exposing the restricted data.

Setup and configuration

A local installation requires Node.js 18 or newer and the CREHQ_API_KEY environment variable. The published package can be started with:

bash
CREHQ_API_KEY=crehq_live_xxxxx npx crehq-mcp-server

For a source build, clone the repository, run npm install, compile with npm run build, and start node dist/index.js with the key in the environment. The repository also provides a test script that checks six read endpoints against the live API.

Free sandbox keys are issued through CREHQ’s developer page and include bounded usage. Pro, dataset, Intelligence, and Enterprise access provide different limits and data rights. Claude Desktop can launch the npm package as a stdio server, while other stdio-capable clients can run the same command or the compiled entry point. Remote clients can use the hosted MCP URL and authorize with the key.

Tools and capabilities

CREHQ Location Intelligence MCP server includes tools for:

  • Searching and retrieving company profiles, ownership, franchise economics, real-estate criteria, contacts, and credit signals.
  • Listing, searching, retrieving, geospatially querying, and bulk-loading locations.
  • Reading location events, individual site histories, company changes, past occupancy, and address timelines.
  • Comparing geographic concentration and brand-level outlet, fee, or financial trends.
  • Accessing dataset catalogs, downloads, purchased snapshots, and rows from eligible purchased datasets.
  • Routing upgrade requests and providing a controlled intelligence preview for eligible Pro keys.

Limitations and notes

Free and Pro credentials do not expose every tool or field. Usage limits, row budgets, resolver quotas, and monthly preview allowances are enforced by CREHQ. Premium intelligence and dataset access may require separate licensing, and redistribution or embedded-use rights are not implied by API access.

The three modeled site-profile routes may return HTTP 404 while production approval is pending. Their results must be treated as CREHQ-modeled outputs based on observed location and context data, not as company-stated requirements unless the response includes explicit provenance. A checkout does not upgrade the current credential in place; a newly issued Pro key must be installed before retrying.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about CREHQ Location Intelligence

CREHQ Location Intelligence is an MCP server that connects AI clients to CREHQ’s live location-intelligence REST API. Its main tools resolve venue affiliations, search brands and locations, inspect occupancy history, retrieve franchise and credit data, analyze trends, and access eligible datasets according to the connected API key.

Install it with Node.js 18 or newer by running `CREHQ_API_KEY=crehq_live_xxxxx npx crehq-mcp-server`. You can also clone the repository, install dependencies, build the TypeScript source, and run `node dist/index.js` with the key set.

Add the npm package as a stdio MCP server in Claude Desktop’s configuration and provide `CREHQ_API_KEY` in the `env` object. Restart Claude Desktop afterward so the CREHQ tools become available.

Yes. Cursor can connect through the local stdio server using the same `npx crehq-mcp-server` command and `CREHQ_API_KEY` environment variable used by other stdio-capable MCP clients.

An upgrade response means the API key lacks the required entitlement, while a 404 can occur for the modeled site-profile routes because their production REST routes are still pending approval. Key limits and licensing control access to premium data.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCREHQ Location Intelligence AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/crehq-location-intelligence?style=directory)](https://allmcps.com/mcp/crehq-location-intelligence)
HTML Embed
<a href="https://allmcps.com/mcp/crehq-location-intelligence"><img src="https://allmcps.com/api/badge/crehq-location-intelligence?style=directory" alt="CREHQ Location Intelligence on AllMCPs" /></a>