crehq-mcp-server 0.1.0

package/.env.example

@@ -0,0 +1,18 @@
+# CREHQ MCP Server configuration
+#
+# Get a FREE sandbox key (1,000 calls/mo, no credit card) at:
+#   https://crehq.com/developers/sandbox/
+# or:
+#   curl -X POST "https://crehq.com/wp-json/crehq/v1/selfserve/signup" \
+#        -H "Content-Type: application/json" \
+#        -d '{"email":"you@example.com"}'
+# The key is delivered by email and looks like: crehq_live_xxxxxxxx...
+
+# REQUIRED: your CREHQ API key (sandbox, dev, production, or enterprise tier).
+CREHQ_API_KEY=crehq_live_your_key_here
+
+# OPTIONAL: override the API base URL (defaults to the value below).
+CREHQ_API_BASE=https://crehq.com/wp-json/crehq/v1
+
+# OPTIONAL: per-request timeout in milliseconds (default 30000).
+CREHQ_TIMEOUT_MS=30000

package/GO-LIVE.md

@@ -0,0 +1,81 @@
+# GO-LIVE checklist — shipping the CREHQ MCP server
+
+This is a runnable proof-of-concept today. To turn it into a product CREHQ can
+distribute, here's what's left, in order.
+
+## 1. Keys & access (smallest lift, do first)
+- [ ] Confirm the self-serve sandbox flow (`POST /selfserve/signup`) actually
+      emails a `crehq_live_…` key, and verify the key works with `./test.sh`.
+      The key table (`xcrehqy_crehq_api_keys`) stores keys **hashed**
+      (`key_prefix` + `key_hash`), so the plaintext is only seen once at issue.
+- [ ] Decide the tier gate for MCP users (sandbox to try, paid for production).
+      Premium tools (`crehq_whitespace`, `crehq_co_tenancy`, `crehq_site_timeline`)
+      are Intel/Enterprise-only — make sure the API returns a clean 403 with an
+      upgrade message for lower tiers (the server already surfaces that hint).
+- [ ] Verify the documented endpoints all exist on prod with the exact paths
+      this server uses (companies, locations, sites/timeline, intelligence,
+      datasets, trends). `./test.sh` covers the read GETs; spot-check
+      `/sites/{uid}/timeline`, `/intelligence/*`, `/companies/{id}/occupancy`.
+
+## 2. Hosting / distribution model — pick one (or do both)
+
+**A. Local stdio (ship now).** Users run `node dist/index.js` from their own
+machine with their key in env. Zero infra for CREHQ. This is the default and
+what Claude Desktop / Cursor / Claude Code expect.
+- [ ] Publish to npm as `crehq-mcp-server` (already configured with a `bin`)
+      so users can `npx crehq-mcp-server` — no clone/build step.
+- [ ] Tag a GitHub release; add CI that runs `npm run build` + `npm run typecheck`.
+
+**B. Hosted / remote MCP server (scales to non-technical users & web Claude).**
+Wrap the same tool handlers behind a Streamable-HTTP / SSE transport
+(`@modelcontextprotocol/sdk` server with `StreamableHTTPServerTransport`) so
+users add a URL instead of installing anything. This is required for the
+Claude **connector directory** and for Claude.ai web/mobile.
+- [ ] Add an HTTP transport entrypoint alongside the stdio one (share `tools.ts`).
+- [ ] Add OAuth 2.1 (the MCP authorization spec) or a hosted key-exchange so a
+      user authorizes once and CREHQ maps the session → their API key, instead
+      of pasting a raw key. This is the main net-new work for option B.
+- [ ] Deploy (Cloudflare Workers has first-class remote-MCP support, or any
+      Node host: Fly/Render/Lambda). Terminate TLS, set rate limits per session.
+
+## 3. Listings / discovery
+- [ ] **Anthropic connector / MCP directory** — submit the hosted server (needs
+      option B + OAuth). Highest-intent channel for Claude users.
+- [ ] **`modelcontextprotocol/servers`** GitHub list — PR adding CREHQ under
+      community servers (works for the stdio version).
+- [ ] **mcp.so**, **Smithery**, **PulseMCP**, **Glama** — submit listings;
+      Smithery can host/build the stdio server for users automatically.
+- [ ] Add an `mcp` badge + "Connect to Claude" snippet to https://crehq.com/developers/.
+
+## 4. Productizing & metered pricing (the business case)
+The MCP server is a new, low-friction sales surface: an agent reads the tool
+descriptions and pulls users into CREHQ data mid-conversation. Suggested
+per-call metered tier on top of the existing $99/$1,500/$20k plans:
+- [ ] **Free**: ~100 lookups/mo (maps to the sandbox key) — let agents try it.
+- [ ] **Metered**: ~$20–$50 per 1,000 lookups for standard company/location reads.
+- [ ] **Premium per-call**: higher unit price (or an add-on) for the
+      differentiators — `whitespace`, `co-tenancy`, `site-timeline`,
+      `occupancy` — since those are the unique, defensible answers.
+- [ ] Meter on the existing `selfserve/usage` endpoint + `request_count` /
+      `rate_limit_per_min` columns already on the key table; bill via Stripe.
+- [ ] Track which tools convert (the descriptions are the sales copy) and
+      iterate on wording.
+
+## 5. Hardening before "production"
+- [ ] Pin the SDK version and add a smoke test in CI that boots the server,
+      lists tools, and asserts a known error shape (the repo already has the
+      one-off harness used to verify this — promote it to a test).
+- [ ] Add structured logging (stderr only — stdout is the protocol channel).
+- [ ] Add a lightweight client-side cache/backoff for the cached intel
+      endpoints (`X-CREHQ-Cache`, 6h TTL) to save quota.
+- [ ] Confirm response shapes match the tool descriptions with a real key, and
+      tighten any field docs that drift from production.
+- [ ] Security review: never log the API key; redact it from any error output.
+
+## Status of this artifact
+- ✅ Builds & typechecks clean (`npm run build`, `npm run typecheck`).
+- ✅ 24 tools, correct names/descriptions/JSON schemas, Zod-validated inputs.
+- ✅ Verified end-to-end against the **live** API (real 403 + correct hint;
+      MCP handshake, tool list, and validation all pass over stdio).
+- ⏳ Real data rows pending a valid `CREHQ_API_KEY` (sandbox key is emailed).
+- ⛔ No production data was created or modified to build this.

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 CREHQ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+----------------------------------------------------------------------
+
+NOTE: This MIT license covers ONLY the source code of this MCP server (the
+API wrapper). It does NOT grant any rights to the CREHQ data accessed through
+it. The CREHQ location-intelligence data is proprietary and is provided solely
+under CREHQ's API terms and your applicable API tier/contract. See NOTICE.

package/NOTICE

@@ -0,0 +1,28 @@
+CREHQ MCP Server
+================
+
+This package contains TWO distinct things with TWO distinct licenses:
+
+1. THE CODE (this MCP server / API wrapper)
+   -----------------------------------------
+   Licensed under the MIT License (see LICENSE). You may freely use, copy,
+   modify, and redistribute the source code of this server.
+
+2. THE DATA (everything the server fetches from the CREHQ API)
+   -----------------------------------------------------------
+   The CREHQ location-intelligence data accessed through this server —
+   franchise/brand records, store-level location data, FDD financials,
+   site tenancy history, whitespace, co-tenancy, datasets, trends, and any
+   other content returned by https://crehq.com/wp-json/crehq/v1 — is
+   PROPRIETARY to CREHQ and is NOT covered by the MIT license above.
+
+   That data is provided solely under CREHQ's API Terms and the terms of your
+   applicable API tier or contract. Your right to retrieve, store, display,
+   resell, or redistribute CREHQ data is governed entirely by those terms,
+   independent of the open-source license on this code.
+
+   - API & data license terms: https://crehq.com/license-terms/
+   - Enterprise / commercial licensing: enterprise@crehq.com
+
+   Use of an API key constitutes acceptance of CREHQ's API terms. Removing or
+   modifying this NOTICE does not change your obligations regarding CREHQ data.

package/README.md

@@ -0,0 +1,177 @@
+# CREHQ MCP Server
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that turns
+[CREHQ](https://crehq.com)'s **live location-intelligence REST API** into native
+tools for Claude and other AI agents. Ask an agent *"where should Chipotle open
+next?"*, *"who has ever occupied this address?"*, or *"what are Planet Fitness's
+franchise fees and where are they expanding?"* — and it can actually answer,
+backed by CREHQ's canonical, **multi-source government-verified** database of
+franchise & multi-unit brands, individual storefronts, FDD financials, 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 (24 tools)
+
+**Companies / brands**
+- `crehq_companies_list` — list brands, filter by category & expansion status
+- `crehq_companies_search` — resolve a brand name → CREHQ company id (start here)
+- `crehq_company_get` — canonical brand profile, verified unit count, ownership
+- `crehq_company_franchise` — FDD fees, royalties, investment, Item 19 figures
+- `crehq_company_real_estate` — site-selection criteria & target geographies
+- `crehq_company_contacts` — real-estate / development decision-maker contacts
+
+**Locations**
+- `crehq_locations_list` — store records by brand / state / category
+- `crehq_location_get` — one location with full attributes & verification trace
+- `crehq_locations_search` — fuzzy multi-field location search
+- `crehq_locations_nearby` — radius search around a lat/lng (trade-area mapping)
+- `crehq_locations_bulk` — bulk pull by id list, brand list, or GeoJSON polygon
+- `crehq_locations_events` — cross-brand open/close/relocate lifecycle stream
+- `crehq_location_history` — full event log for one physical store
+
+**History & flagship differentiators**
+- `crehq_company_changes` — date-bounded change feed for one brand
+- `crehq_company_occupancy` — point-in-time roster (footprint on a past date)
+- `crehq_site_timeline` — **every brand that ever occupied an address, over time**
+
+**Premium intelligence** (Intel & Enterprise tiers)
+- `crehq_whitespace` — markets where competitors are present but the brand isn't
+- `crehq_co_tenancy` — which brands cluster near this brand's stores
+
+**Datasets**
+- `crehq_datasets_list` / `crehq_dataset_get` / `crehq_dataset_download` / `crehq_dataset_categories`
+
+**Trends**
+- `crehq_trends_company` — outlet/fee/financial time series for a brand
+- `crehq_trends_geographic` — metro/state concentration & velocity
+
+---
+
+## Getting an API key
+
+1. **Free sandbox** (1,000 calls/mo, 2 req/s, no credit card):
+   https://crehq.com/developers/sandbox/ — enter your email and a key is
+   emailed to you. Or request one via the API:
+   ```bash
+   curl -X POST "https://crehq.com/wp-json/crehq/v1/selfserve/signup" \
+     -H "Content-Type: application/json" \
+     -d '{"email":"you@example.com"}'
+   ```
+   The key is delivered by email only and looks like `crehq_live_xxxxxxxx…`.
+2. **Paid tiers** — Developer from **$99/mo**, Production from **$1,500/mo**,
+   Enterprise **$20k+/yr** (dedicated key, SLA, premium intel endpoints).
+   See https://crehq.com/developers/ and https://crehq.com/apis/.
+
+---
+
+## Install & build
+
+Requires Node.js ≥ 18.
+
+```bash
+git clone <this-repo> crehq-mcp-server
+cd crehq-mcp-server
+npm install
+npm run build          # compiles TypeScript → dist/
+cp .env.example .env    # then edit .env and set CREHQ_API_KEY
+```
+
+Verify your key against the live API before wiring up a client:
+
+```bash
+export CREHQ_API_KEY=crehq_live_xxxxx
+./test.sh               # exercises 6 read endpoints with curl
+```
+
+Run the server standalone (it speaks MCP over stdio, so it will wait for a
+client on stdin — Ctrl-C to exit):
+
+```bash
+CREHQ_API_KEY=crehq_live_xxxxx node dist/index.js
+```
+
+---
+
+## Connect to Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "crehq": {
+      "command": "node",
+      "args": ["/absolute/path/to/crehq-mcp-server/dist/index.js"],
+      "env": {
+        "CREHQ_API_KEY": "crehq_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The CREHQ tools appear under the tools (🔌) menu.
+
+### Other MCP clients
+
+Any stdio-capable MCP client (Claude Code, Cursor, Cline, Continue, the
+`mcp` CLI, custom `@modelcontextprotocol/sdk` clients, etc.) connects the same
+way — run `node dist/index.js` as the server command with `CREHQ_API_KEY` in
+the environment.
+
+**Claude Code:**
+```bash
+claude mcp add crehq --env CREHQ_API_KEY=crehq_live_xxxxx -- node /absolute/path/to/crehq-mcp-server/dist/index.js
+```
+
+---
+
+## Configuration
+
+| Env var            | Required | Default                                      | Purpose                              |
+|--------------------|----------|----------------------------------------------|--------------------------------------|
+| `CREHQ_API_KEY`    | yes      | —                                            | Your `crehq_live_…` key              |
+| `CREHQ_API_BASE`   | no       | `https://crehq.com/wp-json/crehq/v1`         | Override API base (staging/proxy)    |
+| `CREHQ_TIMEOUT_MS` | no       | `30000`                                      | Per-request timeout in ms            |
+
+---
+
+## Error handling
+
+Tools never crash the agent's turn — failures come back as a readable message
+with a fix-it hint:
+
+- **No key set** → instructs you to set `CREHQ_API_KEY` and links the sandbox.
+- **401 / 403** → "invalid or revoked key / endpoint not in your tier" + upgrade link.
+- **404** → "check the id/slug; resolve it with a search tool first."
+- **429** → respects `Retry-After`; reminds you of the free-tier 2 req/s limit.
+- **5xx / timeout / network** → transient-error guidance to retry with backoff.
+
+Pagination, cache, and stream cursors (`X-WP-Total`, `X-CREHQ-Next-Since`,
+`X-CREHQ-Cache`, rate-limit headers) are surfaced in a `response metadata`
+footer on each result so the agent can paginate and poll correctly.
+
+---
+
+## Note on testing
+
+The build, typecheck, MCP protocol handshake, tool catalog, argument
+validation, and the full HTTP request/response/error pipeline are verified
+end-to-end against the **live** production API (a real request returns a real
+`403 Invalid or revoked API key` with the correct hint). Fetching real data
+rows requires a valid key — the sandbox key is delivered by email, so set
+`CREHQ_API_KEY` and run `./test.sh` to confirm live data responses.
+
+---
+
+## License
+
+MIT. CREHQ data is licensed separately per your API tier/contract.

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Thin HTTP client for the CREHQ REST API (https://crehq.com/wp-json/crehq/v1).
+ *
+ * Responsibilities:
+ *  - Inject the API key (Authorization: Bearer + X-API-Key, per the docs).
+ *  - Build query strings / JSON bodies.
+ *  - Map HTTP failures (401/403/404/429/4xx/5xx) into clear, agent-readable
+ *    errors that point the user at the sandbox signup when appropriate.
+ *  - Surface CREHQ pagination + cache + stream headers to the caller.
+ */
+export declare const DEFAULT_API_BASE = "https://crehq.com/wp-json/crehq/v1";
+export interface CrehqConfig {
+    apiKey: string;
+    apiBase: string;
+    timeoutMs: number;
+}
+export interface CrehqResult {
+    /** Parsed JSON body (object or array), or raw text when not JSON. */
+    data: unknown;
+    /** Selected response headers (pagination/cache/stream cursors). */
+    meta: Record<string, string>;
+}
+/**
+ * Error that carries enough context for the tool layer to produce a helpful,
+ * non-fatal message back to the LLM instead of crashing the server.
+ */
+export declare class CrehqApiError extends Error {
+    readonly status: number;
+    readonly hint: string;
+    constructor(status: number, message: string, hint?: string);
+}
+export declare function loadConfig(): CrehqConfig;
+type QueryValue = string | number | boolean | undefined | null;
+export interface RequestOptions {
+    method?: "GET" | "POST" | "DELETE" | "PUT";
+    /** Query string parameters; undefined/null values are dropped. */
+    query?: Record<string, QueryValue>;
+    /** JSON request body (for POST/PUT). */
+    body?: unknown;
+    /** Desired representation, sent as the Accept header (e.g. text/csv). */
+    accept?: string;
+}
+export declare class CrehqClient {
+    private readonly config;
+    constructor(config: CrehqConfig);
+    /** True when no key is configured — lets tools fail fast with guidance. */
+    get hasKey(): boolean;
+    /**
+     * Perform a request against a CREHQ endpoint path (e.g. "/companies").
+     * Throws CrehqApiError on any non-2xx response or transport failure.
+     */
+    request(path: string, opts?: RequestOptions): Promise<CrehqResult>;
+    /** Map a non-2xx response into a CrehqApiError with an actionable hint. */
+    private toApiError;
+}
+export {};

package/dist/client.js

@@ -0,0 +1,157 @@
+/**
+ * Thin HTTP client for the CREHQ REST API (https://crehq.com/wp-json/crehq/v1).
+ *
+ * Responsibilities:
+ *  - Inject the API key (Authorization: Bearer + X-API-Key, per the docs).
+ *  - Build query strings / JSON bodies.
+ *  - Map HTTP failures (401/403/404/429/4xx/5xx) into clear, agent-readable
+ *    errors that point the user at the sandbox signup when appropriate.
+ *  - Surface CREHQ pagination + cache + stream headers to the caller.
+ */
+export const DEFAULT_API_BASE = "https://crehq.com/wp-json/crehq/v1";
+const SANDBOX_URL = "https://crehq.com/developers/sandbox/";
+/** Headers worth surfacing back to the agent (pagination, cache, event streams). */
+const SURFACED_HEADERS = [
+    "x-wp-total",
+    "x-wp-totalpages",
+    "x-crehq-next-since",
+    "x-crehq-cache",
+    "x-ratelimit-remaining",
+    "x-ratelimit-limit",
+    "retry-after",
+    "link",
+];
+/**
+ * Error that carries enough context for the tool layer to produce a helpful,
+ * non-fatal message back to the LLM instead of crashing the server.
+ */
+export class CrehqApiError extends Error {
+    status;
+    hint;
+    constructor(status, message, hint = "") {
+        super(message);
+        this.name = "CrehqApiError";
+        this.status = status;
+        this.hint = hint;
+    }
+}
+export function loadConfig() {
+    const apiKey = (process.env.CREHQ_API_KEY ?? "").trim();
+    const apiBase = (process.env.CREHQ_API_BASE ?? DEFAULT_API_BASE).trim().replace(/\/+$/, "");
+    const timeoutMs = Number.parseInt(process.env.CREHQ_TIMEOUT_MS ?? "30000", 10) || 30000;
+    return { apiKey, apiBase, timeoutMs };
+}
+export class CrehqClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /** True when no key is configured — lets tools fail fast with guidance. */
+    get hasKey() {
+        return this.config.apiKey.length > 0;
+    }
+    /**
+     * Perform a request against a CREHQ endpoint path (e.g. "/companies").
+     * Throws CrehqApiError on any non-2xx response or transport failure.
+     */
+    async request(path, opts = {}) {
+        if (!this.hasKey) {
+            throw new CrehqApiError(401, "No CREHQ_API_KEY configured.", `Set the CREHQ_API_KEY environment variable. Get a free sandbox key at ${SANDBOX_URL}.`);
+        }
+        const url = new URL(this.config.apiBase + path);
+        if (opts.query) {
+            for (const [key, value] of Object.entries(opts.query)) {
+                if (value === undefined || value === null || value === "")
+                    continue;
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const headers = {
+            // The CREHQ docs accept either header; we send both for maximum
+            // compatibility across gateway configurations.
+            Authorization: `Bearer ${this.config.apiKey}`,
+            "X-API-Key": this.config.apiKey,
+            Accept: opts.accept ?? "application/json",
+            "User-Agent": "crehq-mcp-server/0.1.0",
+        };
+        const init = { method: opts.method ?? "GET", headers };
+        if (opts.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(opts.body);
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        init.signal = controller.signal;
+        let res;
+        try {
+            res = await fetch(url, init);
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (err instanceof Error && err.name === "AbortError") {
+                throw new CrehqApiError(504, `Request to ${path} timed out after ${this.config.timeoutMs}ms.`, "Retry, narrow the query (smaller per_page / tighter filters), or raise CREHQ_TIMEOUT_MS.");
+            }
+            throw new CrehqApiError(0, `Network error calling CREHQ (${path}): ${err.message}`, "Check connectivity to crehq.com and the CREHQ_API_BASE value.");
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const meta = {};
+        for (const name of SURFACED_HEADERS) {
+            const v = res.headers.get(name);
+            if (v)
+                meta[name] = v;
+        }
+        const contentType = res.headers.get("content-type") ?? "";
+        const isJson = contentType.includes("json");
+        const rawText = await res.text();
+        let parsed = rawText;
+        if (isJson && rawText) {
+            try {
+                parsed = JSON.parse(rawText);
+            }
+            catch {
+                parsed = rawText;
+            }
+        }
+        if (!res.ok) {
+            throw this.toApiError(res.status, parsed, meta);
+        }
+        return { data: parsed, meta };
+    }
+    /** Map a non-2xx response into a CrehqApiError with an actionable hint. */
+    toApiError(status, body, meta) {
+        const apiMessage = extractMessage(body);
+        switch (status) {
+            case 401:
+                return new CrehqApiError(401, apiMessage ?? "Unauthorized: no API key was accepted.", `Set CREHQ_API_KEY to a valid key. Get a free sandbox key (1,000 calls/mo, no credit card) at ${SANDBOX_URL}.`);
+            case 403:
+                return new CrehqApiError(403, apiMessage ?? "Forbidden: the API key is invalid, revoked, or not scoped for this endpoint.", `Verify the key is active and that your tier includes this endpoint. Upgrade or request scope at https://crehq.com/api-keys/. Sandbox keys: ${SANDBOX_URL}.`);
+            case 404:
+                return new CrehqApiError(404, apiMessage ?? "Not found: the requested record or path does not exist.", "Check the id/slug/uid. Use the search tools to resolve an identifier first.");
+            case 429: {
+                const retry = meta["retry-after"];
+                return new CrehqApiError(429, apiMessage ?? "Rate limited.", retry
+                    ? `Slow down and retry after ${retry}s.`
+                    : "Slow down (free tier is 2 req/s, 1,000 calls/mo) and retry shortly. Higher limits are available on paid tiers.");
+            }
+            default:
+                if (status >= 500) {
+                    return new CrehqApiError(status, apiMessage ?? `CREHQ server error (${status}).`, "This is a transient server-side issue. Retry with backoff; if it persists, contact CREHQ.");
+                }
+                return new CrehqApiError(status, apiMessage ?? `Request failed (${status}).`, "Review the parameters against the tool's input schema.");
+        }
+    }
+}
+/** Pull a human message out of a WP-REST / CREHQ error body. */
+function extractMessage(body) {
+    if (body && typeof body === "object" && "message" in body) {
+        const m = body.message;
+        if (typeof m === "string" && m.length > 0)
+            return m;
+    }
+    if (typeof body === "string" && body.length > 0 && body.length < 500)
+        return body;
+    return undefined;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Helpers to turn a CrehqResult into the MCP tool-result content blocks the
+ * SDK expects, and to render CrehqApiError into a non-fatal, agent-readable
+ * message (tools surface errors as content + isError, never by throwing, so a
+ * single failing call doesn't kill the agent's turn).
+ */
+import { type CrehqResult } from "./client.js";
+export interface ToolContent {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+}
+/** Wrap a successful API result as a pretty-printed JSON text block + meta. */
+export declare function ok(result: CrehqResult): ToolContent;
+/** Wrap a caught error as a non-fatal tool error with an actionable hint. */
+export declare function fail(err: unknown): ToolContent;

package/dist/format.js

@@ -0,0 +1,46 @@
+/**
+ * Helpers to turn a CrehqResult into the MCP tool-result content blocks the
+ * SDK expects, and to render CrehqApiError into a non-fatal, agent-readable
+ * message (tools surface errors as content + isError, never by throwing, so a
+ * single failing call doesn't kill the agent's turn).
+ */
+import { CrehqApiError } from "./client.js";
+/** Wrap a successful API result as a pretty-printed JSON text block + meta. */
+export function ok(result) {
+    const metaKeys = Object.keys(result.meta);
+    const metaNote = metaKeys.length > 0
+        ? `\n\n--- response metadata ---\n${formatMeta(result.meta)}`
+        : "";
+    return {
+        content: [{ type: "text", text: JSON.stringify(result.data, null, 2) + metaNote }],
+    };
+}
+/** Wrap a caught error as a non-fatal tool error with an actionable hint. */
+export function fail(err) {
+    if (err instanceof CrehqApiError) {
+        const lines = [`CREHQ API error (HTTP ${err.status || "n/a"}): ${err.message}`];
+        if (err.hint)
+            lines.push(`Suggestion: ${err.hint}`);
+        return { content: [{ type: "text", text: lines.join("\n") }], isError: true };
+    }
+    return {
+        content: [{ type: "text", text: `Unexpected error: ${err.message}` }],
+        isError: true,
+    };
+}
+function formatMeta(meta) {
+    const labels = {
+        "x-wp-total": "total_results",
+        "x-wp-totalpages": "total_pages",
+        "x-crehq-next-since": "next_since_cursor",
+        "x-crehq-cache": "cache",
+        "x-ratelimit-remaining": "rate_limit_remaining",
+        "x-ratelimit-limit": "rate_limit",
+        "retry-after": "retry_after_seconds",
+    };
+    return Object.entries(meta)
+        .filter(([k]) => k !== "link")
+        .map(([k, v]) => `${labels[k] ?? k}: ${v}`)
+        .join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAC;AAO9D,+EAA+E;AAC/E,MAAM,UAAU,EAAE,CAAC,MAAmB;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,kCAAkC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QAC7D,CAAC,CAAC,EAAE,CAAC;IACT,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,IAAI,CAAC,GAAY;IAC/B,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,CAAC,yBAAyB,GAAG,CAAC,MAAM,IAAI,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAChF,IAAI,GAAG,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAChF,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAsB,GAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QAChF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAA4B;IAC9C,MAAM,MAAM,GAA2B;QACrC,YAAY,EAAE,eAAe;QAC7B,iBAAiB,EAAE,aAAa;QAChC,oBAAoB,EAAE,mBAAmB;QACzC,eAAe,EAAE,OAAO;QACxB,uBAAuB,EAAE,sBAAsB;QAC/C,mBAAmB,EAAE,YAAY;QACjC,aAAa,EAAE,qBAAqB;KACrC,CAAC;IACF,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;SAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * CREHQ MCP server — exposes CREHQ's live location-intelligence REST API
+ * (https://crehq.com/wp-json/crehq/v1) as Model Context Protocol tools so that
+ * Claude and other MCP clients can query brands, locations, FDD financials,
+ * site-level tenancy history, whitespace, and co-tenancy as native tools.
+ *
+ * Transport: stdio (the standard for Claude Desktop / local connectors).
+ * Auth:      CREHQ_API_KEY env var (sandbox/dev/prod/enterprise).
+ *
+ * This wraps an EXISTING production API; it does not modify any server-side
+ * data. See README.md for setup and GO-LIVE.md for shipping.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { CrehqClient, loadConfig } from "./client.js";
+import { TOOLS, toJsonSchema } from "./tools.js";
+async function main() {
+    const config = loadConfig();
+    const client = new CrehqClient(config);
+    // Warn (to stderr — never stdout, which carries the MCP protocol) if no key.
+    if (!client.hasKey) {
+        process.stderr.write("[crehq-mcp] WARNING: CREHQ_API_KEY is not set. Tools will return an auth hint until a key is configured. " +
+            "Get a free sandbox key at https://crehq.com/developers/sandbox/\n");
+    }
+    const server = new Server({ name: "crehq-mcp-server", version: "0.1.0" }, { capabilities: { tools: {} } });
+    // Advertise the tool catalog (names + descriptions + JSON schemas).
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: toJsonSchema(t.schema),
+        })),
+    }));
+    // Dispatch a tool call: validate args with Zod, then run the handler.
+    // (Results are cast to the SDK's CallToolResult shape; our ToolContent is a
+    // structural subset — content blocks + optional isError.)
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = TOOLS.find((t) => t.name === request.params.name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }],
+                isError: true,
+            };
+        }
+        const parsed = z.object(tool.schema).safeParse(request.params.arguments ?? {});
+        if (!parsed.success) {
+            const issues = parsed.error.issues
+                .map((i) => `- ${i.path.join(".") || "(root)"}: ${i.message}`)
+                .join("\n");
+            return {
+                content: [{ type: "text", text: `Invalid arguments for ${tool.name}:\n${issues}` }],
+                isError: true,
+            };
+        }
+        try {
+            return (await tool.handler(client, parsed.data));
+        }
+        catch (err) {
+            // Defensive net: handlers already convert CrehqApiError to content, but a
+            // truly unexpected throw should still not kill the server.
+            return {
+                content: [{ type: "text", text: `Unhandled error in ${tool.name}: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[crehq-mcp] CREHQ MCP server ready over stdio with ${TOOLS.length} tools. Base: ${config.apiBase}\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[crehq-mcp] Fatal: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CREHQ MCP tool registry.
+ *
+ * Each entry pairs an LLM-facing name + description (the description is a sales
+ * surface — it tells Claude what CREHQ uniquely can answer) with a Zod input
+ * schema and a handler that maps to one CREHQ REST endpoint.
+ *
+ * Endpoint contract sourced from https://crehq.com/developers/ and
+ * https://crehq.com/apis/ (verified 2026-06-17).
+ */
+import { type ZodRawShape } from "zod";
+import type { CrehqClient } from "./client.js";
+import { type ToolContent } from "./format.js";
+export interface ToolDef {
+    name: string;
+    description: string;
+    schema: ZodRawShape;
+    handler: (client: CrehqClient, args: Record<string, unknown>) => Promise<ToolContent>;
+}
+export declare const TOOLS: ToolDef[];
+/** Convert a Zod raw shape to the JSON Schema the MCP SDK advertises to clients. */
+export declare function toJsonSchema(shape: ZodRawShape): {
+    type: "object";
+    properties: Record<string, unknown>;
+    required: string[];
+};

package/dist/tools.js

@@ -0,0 +1,335 @@
+/**
+ * CREHQ MCP tool registry.
+ *
+ * Each entry pairs an LLM-facing name + description (the description is a sales
+ * surface — it tells Claude what CREHQ uniquely can answer) with a Zod input
+ * schema and a handler that maps to one CREHQ REST endpoint.
+ *
+ * Endpoint contract sourced from https://crehq.com/developers/ and
+ * https://crehq.com/apis/ (verified 2026-06-17).
+ */
+import { z } from "zod";
+import { ok, fail } from "./format.js";
+/** Run a request and normalize success/error into MCP content. */
+async function call(fn) {
+    try {
+        return ok(await fn());
+    }
+    catch (err) {
+        return fail(err);
+    }
+}
+// --- shared schema fragments -------------------------------------------------
+const perPage = z
+    .number()
+    .int()
+    .min(1)
+    .max(200)
+    .optional()
+    .describe("Results per page (max 200, default 50).");
+const page = z.number().int().min(1).optional().describe("Page number for cursor/offset pagination (default 1).");
+export const TOOLS = [
+    // ========================================================================
+    // COMPANIES / BRANDS
+    // ========================================================================
+    {
+        name: "crehq_companies_list",
+        description: "List franchise & multi-unit brands (companies) tracked in CREHQ's canonical, multi-source government-verified location database — restaurants, retail, banks, auto dealers, healthcare, hotels, EV charging and more. Filter by category or expansion status to discover brands actively opening or closing units. Each record links to verified store counts, FDD financials, real-estate criteria, and decision-maker contacts. Paginated.",
+        schema: {
+            category: z.string().optional().describe("Filter by vertical/category slug, e.g. 'restaurant', 'bank', 'auto-dealer', 'ev-charging'."),
+            expansion_status: z
+                .enum(["expanding", "stable", "contracting"])
+                .optional()
+                .describe("Filter brands by growth trajectory derived from location lifecycle data."),
+            per_page: perPage,
+            page,
+        },
+        handler: (c, a) => call(() => c.request("/companies", {
+            query: { category: a.category, expansion_status: a.expansion_status, per_page: a.per_page, page: a.page },
+        })),
+    },
+    {
+        name: "crehq_companies_search",
+        description: "Full-text search CREHQ's brand universe by name to resolve a company to its canonical CREHQ id. Handles messy/alias names (e.g. 'mcdonald-s' → McDonald's Corporation). ALWAYS use this first to get a company_id before calling company detail, franchise/FDD, real-estate, contacts, occupancy, whitespace, or co-tenancy tools.",
+        schema: {
+            q: z.string().min(1).describe("Search term — brand or company name (partial OK)."),
+            per_page: perPage,
+        },
+        handler: (c, a) => call(() => c.request("/companies/search", { query: { q: a.q, per_page: a.per_page } })),
+    },
+    {
+        name: "crehq_company_get",
+        description: "Get a single brand's canonical CREHQ profile: verified current location count, vertical/category, parent/ownership (incl. private-equity backing where known), geographic footprint summary, and verification trace. The authoritative, de-duplicated source-of-truth record for a brand.",
+        schema: { id: z.union([z.string(), z.number()]).describe("CREHQ company id (from crehq_companies_search).") },
+        handler: (c, a) => call(() => c.request(`/company/${encodeURIComponent(String(a.id))}`)),
+    },
+    {
+        name: "crehq_company_franchise",
+        description: "Retrieve FDD (Franchise Disclosure Document)-derived financials for a brand: franchise fees, royalty rates, total initial investment ranges, and Item 19 financial performance representations where disclosed. Sourced and multi-source-verified from state franchise registries — the hard numbers an analyst, investor, or prospective franchisee needs to underwrite a concept.",
+        schema: { id: z.union([z.string(), z.number()]).describe("CREHQ company id (from crehq_companies_search).") },
+        handler: (c, a) => call(() => c.request(`/company/${encodeURIComponent(String(a.id))}/franchise`)),
+    },
+    {
+        name: "crehq_company_real_estate",
+        description: "Get a brand's site-selection criteria and target real-estate profile: preferred site types, building/lot size, target geographies and trade areas, and expansion markets. Essential for landlords, brokers, and site-selectors who want to know what a tenant is looking for before pitching them space.",
+        schema: { id: z.union([z.string(), z.number()]).describe("CREHQ company id (from crehq_companies_search).") },
+        handler: (c, a) => call(() => c.request(`/company/${encodeURIComponent(String(a.id))}/real-estate`)),
+    },
+    {
+        name: "crehq_company_contacts",
+        description: "Get real-estate decision-maker contacts for a brand (development, site-selection, and franchising roles) compiled from public records and the brand's own disclosures. The shortcut from 'which brand is expanding' to 'who do I email'.",
+        schema: { id: z.union([z.string(), z.number()]).describe("CREHQ company id (from crehq_companies_search).") },
+        handler: (c, a) => call(() => c.request(`/company/${encodeURIComponent(String(a.id))}/contacts`)),
+    },
+    // ========================================================================
+    // LOCATIONS
+    // ========================================================================
+    {
+        name: "crehq_locations_list",
+        description: "List individual store/branch/site records, filterable by brand, US state, and category. Each location carries a stable entity_uid, geocoded address, open/closed status, and a multi-source verification trace. The raw, government-cross-checked footprint behind any brand.",
+        schema: {
+            brand: z.string().optional().describe("Brand slug or name to filter by (e.g. 'planet-fitness')."),
+            state: z.string().optional().describe("US state, 2-letter code or full name (e.g. 'TX')."),
+            category: z.string().optional().describe("Vertical/category slug."),
+            per_page: perPage,
+            page,
+        },
+        handler: (c, a) => call(() => c.request("/locations", {
+            query: { brand: a.brand, state: a.state, category: a.category, per_page: a.per_page, page: a.page },
+        })),
+    },
+    {
+        name: "crehq_location_get",
+        description: "Get one location's full record by id: geocoded address, brand, lifecycle status, attributes (e.g. drive-thru, square footage, fuel/EV ports where applicable), and the sources that verify it exists.",
+        schema: { id: z.union([z.string(), z.number()]).describe("CREHQ location id.") },
+        handler: (c, a) => call(() => c.request(`/locations/${encodeURIComponent(String(a.id))}`)),
+    },
+    {
+        name: "crehq_locations_search",
+        description: "Search locations across multiple fields at once — name, brand, street address, city/state/geography. Use when you have a fuzzy description of a physical place rather than an id.",
+        schema: {
+            name: z.string().optional().describe("Location or brand name fragment."),
+            brand: z.string().optional().describe("Brand slug/name."),
+            address: z.string().optional().describe("Street address fragment."),
+            state: z.string().optional().describe("US state code or name."),
+            city: z.string().optional().describe("City name."),
+            per_page: perPage,
+        },
+        handler: (c, a) => call(() => c.request("/locations/search", {
+            query: { name: a.name, brand: a.brand, address: a.address, state: a.state, city: a.city, per_page: a.per_page },
+        })),
+    },
+    {
+        name: "crehq_locations_nearby",
+        description: "Radius search: find all tracked locations within N miles of a lat/lng point. Powers trade-area analysis, competitor mapping, and 'what's near this address' questions. Returns distance-sorted, government-verified storefronts across every vertical CREHQ covers.",
+        schema: {
+            lat: z.number().describe("Latitude (decimal degrees)."),
+            lng: z.number().describe("Longitude (decimal degrees)."),
+            radius_mi: z.number().min(0.1).max(100).optional().describe("Search radius in miles (default 5)."),
+            brand: z.string().optional().describe("Optional: restrict to one brand."),
+            category: z.string().optional().describe("Optional: restrict to one vertical/category."),
+            per_page: perPage,
+        },
+        handler: (c, a) => call(() => c.request("/locations/nearby", {
+            query: { lat: a.lat, lng: a.lng, radius_mi: a.radius_mi, brand: a.brand, category: a.category, per_page: a.per_page },
+        })),
+    },
+    {
+        name: "crehq_locations_bulk",
+        description: "Bulk location retrieval for ETL/pipeline use: fetch many locations in one call by a list of ids, a list of brands, or a GeoJSON polygon (e.g. a custom market boundary). Use this instead of looping single-location calls when hydrating a dataset.",
+        schema: {
+            ids: z.array(z.union([z.string(), z.number()])).optional().describe("Explicit list of location ids/entity_uids."),
+            brands: z.array(z.string()).optional().describe("List of brand slugs to pull all locations for."),
+            polygon: z
+                .unknown()
+                .optional()
+                .describe("GeoJSON Polygon/MultiPolygon geometry; returns locations inside the boundary."),
+            per_page: perPage,
+        },
+        handler: (c, a) => call(() => c.request("/locations/bulk", {
+            method: "POST",
+            body: { ids: a.ids, brands: a.brands, polygon: a.polygon, per_page: a.per_page },
+        })),
+    },
+    {
+        name: "crehq_locations_events",
+        description: "Pull the cross-brand location LIFECYCLE STREAM — openings, closings, relocations, ownership/brand changes — since a timestamp. The real-time expansion/contraction signal that drives prospecting, market-monitoring, and 'who's moving right now' alerts. Returns a next-since cursor for incremental polling.",
+        schema: {
+            since: z.string().describe("ISO-8601 timestamp; returns events on/after this time. Use the returned next_since_cursor for the next poll."),
+            per_page: perPage,
+        },
+        handler: (c, a) => call(() => c.request("/locations/events", { query: { since: a.since, per_page: a.per_page } })),
+    },
+    {
+        name: "crehq_location_history",
+        description: "Full append-only event log for ONE physical store/site (by entity_uid): every open/close/rebrand/attribute change CREHQ has recorded, with dates and sources. Time-series provenance for a single location.",
+        schema: {
+            entity_uid: z.string().describe("Stable CREHQ entity_uid for the location."),
+            limit: z.number().int().min(1).max(1000).optional().describe("Max events to return (default 200, max 1000)."),
+        },
+        handler: (c, a) => call(() => c.request(`/locations/${encodeURIComponent(a.entity_uid)}/history`, { query: { limit: a.limit } })),
+    },
+    // ========================================================================
+    // CHANGES / OCCUPANCY / SITE TIMELINE  (flagship differentiators)
+    // ========================================================================
+    {
+        name: "crehq_company_changes",
+        description: "Date-bounded feed of everything that changed for ONE brand's footprint — openings, closings, relocations, attribute edits — between two timestamps and optionally filtered by event type. The brand-scoped version of the lifecycle stream, ideal for monitoring a target account.",
+        schema: {
+            id: z.union([z.string(), z.number()]).describe("CREHQ company id."),
+            since: z.string().optional().describe("ISO-8601 start timestamp."),
+            until: z.string().optional().describe("ISO-8601 end timestamp."),
+            types: z.string().optional().describe("Comma-separated event types to include (e.g. 'opened,closed,relocated')."),
+            limit: z.number().int().min(1).max(5000).optional().describe("Max events (default 500, max 5000)."),
+        },
+        handler: (c, a) => call(() => c.request(`/companies/${encodeURIComponent(String(a.id))}/changes`, {
+            query: { since: a.since, until: a.until, types: a.types, limit: a.limit },
+        })),
+    },
+    {
+        name: "crehq_company_occupancy",
+        description: "POINT-IN-TIME roster: reconstruct exactly which locations a brand operated on a given historical date. Answers 'how many units did this chain have on 2022-01-01 and where' — true historical footprint, not just today's count. Powers growth-curve and same-store analysis.",
+        schema: {
+            id: z.union([z.string(), z.number()]).describe("CREHQ company id."),
+            date: z.string().optional().describe("ISO date (YYYY-MM-DD) for the snapshot; omit for current."),
+            limit: z.number().int().min(1).max(10000).optional().describe("Max rows (default 1000, max 10000)."),
+            offset: z.number().int().min(0).optional().describe("Row offset for pagination."),
+        },
+        handler: (c, a) => call(() => c.request(`/companies/${encodeURIComponent(String(a.id))}/occupancy`, {
+            query: { date: a.date, limit: a.limit, offset: a.offset },
+        })),
+    },
+    {
+        name: "crehq_site_timeline",
+        description: "FLAGSHIP DIFFERENTIATOR — given a physical site (site_uid), return the full chronological tenancy history: every brand that has EVER occupied that address and when. Answers 'this was a Blockbuster, then a Sprint store, now a Chipotle.' Unmatched for backfill/teardown analysis, second-generation space, and landlord due diligence. No other location dataset reconstructs address-level succession like this.",
+        schema: { site_uid: z.string().describe("Stable CREHQ site_uid for the physical address.") },
+        handler: (c, a) => call(() => c.request(`/sites/${encodeURIComponent(a.site_uid)}/timeline`)),
+    },
+    // ========================================================================
+    // INTELLIGENCE  (premium: Intel + Enterprise tiers)
+    // ========================================================================
+    {
+        name: "crehq_whitespace",
+        description: "PREMIUM INTELLIGENCE — whitespace analysis: postal codes/markets where a brand's competitors are present and performing but the brand itself is ABSENT. The ranked, data-driven shortlist of where a chain should expand next. Built on CREHQ's full multi-vertical, government-verified footprint. (Intel & Enterprise tiers.)",
+        schema: {
+            company_id: z.union([z.string(), z.number()]).describe("CREHQ company id to analyze."),
+            country: z.string().optional().describe("ISO country code (default 'US')."),
+        },
+        handler: (c, a) => call(() => c.request("/intelligence/whitespace", { query: { company_id: String(a.company_id), country: a.country ?? "US" } })),
+    },
+    {
+        name: "crehq_co_tenancy",
+        description: "PREMIUM INTELLIGENCE — co-tenancy analysis: which brands most often co-locate within a given radius of this brand's stores (the chains that cluster together: e.g. who anchors near Chipotle). Drives site-selection, anchor-tenant matching, and trade-area benchmarking. (Intel & Enterprise tiers.)",
+        schema: {
+            company_id: z.union([z.string(), z.number()]).describe("CREHQ company id to analyze."),
+            radius_meters: z.number().int().min(10).max(5000).optional().describe("Co-location radius in meters (default 200)."),
+        },
+        handler: (c, a) => call(() => c.request("/intelligence/co-tenancy", { query: { company_id: String(a.company_id), radius_meters: a.radius_meters ?? 200 } })),
+    },
+    // ========================================================================
+    // DATASETS
+    // ========================================================================
+    {
+        name: "crehq_datasets_list",
+        description: "Browse CREHQ's catalog of packaged, ready-to-license datasets (whole-brand footprints, vertical rollups, FDD financials, etc.), filterable by category, country, and freshness. Each entry exposes row counts, schema, and refresh date — the menu of bulk data products.",
+        schema: {
+            category: z.string().optional().describe("Filter by category slug."),
+            country: z.string().optional().describe("ISO country code filter."),
+            freshness: z.string().optional().describe("Freshness filter (e.g. '30d', '90d')."),
+            per_page: perPage,
+        },
+        handler: (c, a) => call(() => c.request("/datasets", { query: { category: a.category, country: a.country, freshness: a.freshness, per_page: a.per_page } })),
+    },
+    {
+        name: "crehq_dataset_get",
+        description: "Get full metadata for one dataset by slug: row count, column schema, coverage, verification methodology, last-refresh date, and licensing notes — everything needed to evaluate it before download.",
+        schema: { slug: z.string().describe("Dataset slug (from crehq_datasets_list).") },
+        handler: (c, a) => call(() => c.request(`/datasets/${encodeURIComponent(a.slug)}`)),
+    },
+    {
+        name: "crehq_dataset_download",
+        description: "Download a licensed dataset by slug in your chosen format (CSV, JSON, GeoJSON, or XLSX). Requires a tier/contract that includes the dataset. Returns the raw payload (or a signed link) for direct ingestion.",
+        schema: {
+            slug: z.string().describe("Dataset slug."),
+            format: z.enum(["json", "csv", "geojson", "xlsx"]).optional().describe("Desired format (default json)."),
+        },
+        handler: (c, a) => {
+            const format = a.format ?? "json";
+            const acceptMap = {
+                json: "application/json",
+                csv: "text/csv",
+                geojson: "application/geo+json",
+                xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+            };
+            return call(() => c.request(`/datasets/${encodeURIComponent(a.slug)}/download`, { accept: acceptMap[format] }));
+        },
+    },
+    {
+        name: "crehq_dataset_categories",
+        description: "List all dataset categories with counts — a quick map of how CREHQ's data products are organized across verticals.",
+        schema: {},
+        handler: (c) => call(() => c.request("/datasets/categories")),
+    },
+    // ========================================================================
+    // TRENDS
+    // ========================================================================
+    {
+        name: "crehq_trends_company",
+        description: "Time-series trends for ONE brand: outlet-count history, fee/royalty trends, and FDD financial trajectory over time. The growth/health curve of a concept in a single call.",
+        schema: { id: z.union([z.string(), z.number()]).describe("CREHQ company id.") },
+        handler: (c, a) => call(() => c.request(`/trends/company/${encodeURIComponent(String(a.id))}`)),
+    },
+    {
+        name: "crehq_trends_geographic",
+        description: "Geographic trend analysis: metro/state concentration and opening/closing velocity across CREHQ's footprint. Surfaces which markets are heating up or cooling down across brands and verticals.",
+        schema: {
+            country: z.string().optional().describe("ISO country code (default 'US')."),
+            category: z.string().optional().describe("Optional vertical/category filter."),
+            state: z.string().optional().describe("Optional US state filter."),
+        },
+        handler: (c, a) => call(() => c.request("/trends/geographic", { query: { country: a.country, category: a.category, state: a.state } })),
+    },
+];
+/** Convert a Zod raw shape to the JSON Schema the MCP SDK advertises to clients. */
+export function toJsonSchema(shape) {
+    const properties = {};
+    const required = [];
+    for (const [key, def] of Object.entries(shape)) {
+        properties[key] = zodToJson(def);
+        if (!def.isOptional())
+            required.push(key);
+    }
+    return { type: "object", properties, required };
+}
+/** Minimal Zod→JSON-Schema mapping covering the types used in this registry. */
+function zodToJson(def) {
+    const description = def.description;
+    const base = (obj) => description ? { ...obj, description } : obj;
+    const inner = def;
+    const typeName = inner._def.typeName;
+    switch (typeName) {
+        case "ZodOptional":
+        case "ZodDefault":
+            return { ...zodToJson(inner._def.innerType), ...(description ? { description } : {}) };
+        case "ZodString":
+            return base({ type: "string" });
+        case "ZodNumber":
+            return base({ type: "number" });
+        case "ZodBoolean":
+            return base({ type: "boolean" });
+        case "ZodEnum":
+            return base({ type: "string", enum: inner._def.values });
+        case "ZodArray":
+            return base({ type: "array", items: zodToJson(inner._def.type) });
+        case "ZodUnion": {
+            // Used for id fields that accept string|number.
+            const opts = (inner._def.options ?? []).map((o) => zodToJson(o));
+            const types = Array.from(new Set(opts.map((o) => o.type).filter(Boolean)));
+            return base({ type: types.length === 1 ? types[0] : types });
+        }
+        case "ZodUnknown":
+        default:
+            return base({});
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "crehq-mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server that wraps the CREHQ location-intelligence REST API as native AI-agent tools (franchise brands, store locations, FDD financials, site tenancy history, whitespace & co-tenancy).",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "crehq-mcp-server": "dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "location-data",
+    "franchise",
+    "fdd",
+    "retail",
+    "crehq"
+  ],
+  "homepage": "https://crehq.com/developers/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/groundroof/crehq-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/groundroof/crehq-mcp-server/issues"
+  },
+  "author": "CREHQ",
+  "files": [
+    "dist",
+    "README.md",
+    "GO-LIVE.md",
+    "LICENSE",
+    "NOTICE",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}