Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

CREHQ Location Intelligence

von groundroofVersion 0.1.7i★ 0iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.groundroof/crehq-mcp-server

So installierst du es

What it does

CREHQ entity affiliation, brand, site, franchise, credit, and location-intelligence tools.

  • Connects Computer oder Cloud
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs CREHQ_API_KEY
  • Category Reisen, Karten & Wetter

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität7/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert15/100

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte CREHQ Location Intelligence. Folge https://mcp.popnx.com/i/groundroof-crehq-mcp-server.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.crehq.com) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameCREHQ Location Intelligence
    Remote MCP server URL · Adressehttps://mcp.crehq.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsCREHQ Location Intelligence

  4. Ausprobieren

    Nutze CREHQ Location Intelligence und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es CREHQ Location Intelligence nutzt, oder ein Werkzeug von CREHQ Location Intelligence in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameCREHQ Location Intelligence
    Connection · Adressehttps://mcp.crehq.com/mcp
  3. CREHQ Location Intelligence im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen CREHQ Location Intelligence aus deinen Plugins wählen

  4. Ausprobieren

    Nutze CREHQ Location Intelligence und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es CREHQ Location Intelligence nutzt, oder ein Werkzeug von CREHQ Location Intelligence in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user crehq https://mcp.crehq.com/mcp
  3. /mcp in Claude Code eingeben

    CREHQ Location Intelligence sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze CREHQ Location Intelligence und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es CREHQ Location Intelligence nutzt, oder ein Werkzeug von CREHQ Location Intelligence in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze CREHQ Location Intelligence und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es CREHQ Location Intelligence nutzt, oder ein Werkzeug von CREHQ Location Intelligence in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze CREHQ Location Intelligence und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es CREHQ Location Intelligence nutzt, oder ein Werkzeug von CREHQ Location Intelligence in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.crehq.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die CREHQ Location Intelligence nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user crehq https://mcp.crehq.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "crehq": {
      "url": "https://mcp.crehq.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "crehq": {
      "type": "http",
      "url": "https://mcp.crehq.com/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user crehq --env CREHQ_API_KEY=your-value -- npx -y crehq-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "crehq": {
      "command": "npx",
      "args": [
        "-y",
        "crehq-mcp-server"
      ],
      "env": {
        "CREHQ_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "crehq": {
      "command": "npx",
      "args": [
        "-y",
        "crehq-mcp-server"
      ],
      "env": {
        "CREHQ_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "crehq": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "crehq-mcp-server"
      ],
      "env": {
        "CREHQ_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • CREHQ_API_KEY geheim erforderlich env
    Ihr CREHQ-API-Schlüssel. Einen kostenlosen Sandbox-Schlüssel erhalten Sie unter https://crehq.com/developers/sandbox/.
    Englisches Original anzeigenYour CREHQ API key. Get a free sandbox key at https://crehq.com/developers/sandbox/.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
57/Wo.
Lizenzi
Keine Lizenz angegeben
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.1.7
In der Registry veröffentlichti
11. Juli 2026
Code zuletzt geänderti
14. Okt. 2026
Zuletzt geprüft
15. Nov. 2026
Entwickler
groundroof
Pakete
npm: crehq-mcp-server
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto groundroof bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 36 Tagen

  • ! Vorsicht

    Hat eine Lizenz

    GitHub konnte die Lizenzart nicht erkennen; öffne die Datei, um nachzusehen

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 69 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für crehq-mcp-server@0.1.7

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/groundroof-crehq-mcp-server.svg)](https://mcp.popnx.com/en/servers/groundroof-crehq-mcp-server)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Reisen, Karten & Wetteri

  • Mehr Sterne als 0 % der anderen 2015 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 13 % der anderen 2015 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 63 % der anderen 2015 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist CREHQ Location Intelligence sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: CREHQ_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 36 Tagen geändert, und die neueste Version (0.1.7) kam vor 4 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Whimsical, Gondola Award Travel Search

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

von microWachsend★ 440Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

von AwardTravelFinderAm Anfang★ 15Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · awardtravelfinder.com

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

von tengolabsAm Anfang↓ 328/Wo.★ 14Aktualisiert vor 12 Tagen

Läuft auf deinem Computer✓ vom Dienst · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

von WhimsicalCodeAm Anfang★ 11Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · whimsical.com
Im Vergleich mit ähnlichen
Dieser
CREHQ Location Intelligence
MuAward Travel FinderKillbottleneckWhimsicalGondola Award Travel Search
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen4/54/43/33/34/44/4
LizenzNOASSERTIONAGPL-3.0MITMITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

  • crehq_request_upgrade — 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.
  • crehq_intelligence_preview — 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

  • crehq_resolve_entity_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

  • 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_credit_signals — credit profile, sponsor/issuer context, ratings, capital structure
  • 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
  • crehq_location_site_profile — CREHQ Modeled Site Profile for one location
  • crehq_company_site_pattern — empirical brand site pattern from observed footprint/context
  • crehq_recent_location_context — recent observed/opening rows with traffic, demographics, and coverage flags

Modeled Site Profile outputs must be described as CREHQ-modeled from observed location/context data, not as company-stated site requirements unless the response includes explicit stated-requirement provenance.

The Modeled Site Profile REST routes are staged pending explicit production approval. Until those routes are published, these three tools may return a 404 even though the MCP catalog advertises them for local testing.

Datasets

  • crehq_datasets_list / crehq_dataset_get / crehq_dataset_download / crehq_dataset_categories
  • crehq_purchased_datasets_list — list dataset snapshots purchased by the connected key owner, including snapshot date and hosted MCP access status.
  • crehq_purchased_dataset_locations — query rows from a buyer-owned point-in-time dataset snapshot during the hosted access window.

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; rows per brand are limited monthly, and every response shows the exact row budget): https://crehq.com/developers/sandbox/ — enter your email, complete the browser verification challenge, and a key is emailed to you. The key is delivered by email only and looks like crehq_live_xxxxxxxx…. Sandbox keys can run bounded location lookups (crehq_locations_list by brand, and crehq_locations_nearby by radius) and call the entity-affiliation resolver once per month. If the user asks for premium intelligence, call crehq_request_upgrade; it records the requested topic for CREHQ follow-up and tells the user what to upgrade.
  2. Pro MCP — $99/mo, self-serve Stripe checkout. Includes bounded D1 location queries, selected D2 provenance fields, 25,000 core calls/month, up to 250 affiliation resolver calls/month, and one controlled intelligence preview per month. Start at https://crehq.com/developers/sandbox/#pro-checkout.
  3. Datasets / Intelligence / Enterprise — buy licensed point-in-time dataset snapshots when you need the file; use enterprise licensing for premium intelligence, refresh plans, API/feed delivery, redistribution, embedded rights, and SLAs. See https://crehq.com/pricing/.

Fastest way to try CREHQ in an agent

  1. Get a sandbox key at https://crehq.com/developers/sandbox/.
  2. For hosted/remote MCP clients, add https://mcp.crehq.com/mcp and authorize with that key.
  3. For local stdio clients, install with npx -y crehq-mcp-server and set CREHQ_API_KEY.
  4. Ask: Use CREHQ to identify the brand, operator, and parent affiliation of the venue at https://www.earleycrescent.org/.

Self-serve keys expose the affiliation resolver, bounded location lookups, upgrade routing, purchased-dataset access, and the controlled intelligence preview. The backend still enforces the key's actual Free, Pro, and purchased dataset entitlements, returning a structured upgrade or purchase response when needed. Intel and Enterprise keys expose broader API tools according to the key's CREHQ tier.


Install & build

Requires Node.js ≥ 18.

Install the published stdio server with npx:

CREHQ_API_KEY=crehq_live_xxxxx npx crehq-mcp-server

Or build from source:

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:

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):

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
{

"mcpServers": { "crehq": { "command": "npx", "args": ["-y", "crehq-mcp-server"], "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:

claude mcp add crehq --env CREHQ_API_KEY=crehq_live_xxxxx -- npx crehq-mcp-server

Hosted remote connector

The hosted Cloudflare Worker version is kept in remote/. It provides the same CREHQ connector as a remote MCP server at https://mcp.crehq.com/mcp, with OAuth/key exchange and scope gating for premium tools. Its own deploy notes are in remote/DEPLOY.md and connector-submission copy is in remote/CONNECTOR-SUBMISSION.md.

The MCP Registry metadata lives in server.json, with registry ownership declared by mcpName in package.json.

Maintainer workflow

GitHub Actions owns the repeatable release path:

  • CI builds and tests the stdio package and the hosted Worker on every push.
  • Deploy Remote MCP deploys remote/ changes to Cloudflare Workers and then verifies https://mcp.crehq.com/health.
  • Publish npm publishes the stdio package from a vX.Y.Z tag or manual workflow dispatch. It skips safely when that package version already exists.

Required repository secrets are already named:

  • NPM_TOKEN
  • CLOUDFLARE_API_TOKEN
  • CLOUDFLARE_ACCOUNT_ID

Configuration

Env varRequiredDefaultPurpose
CREHQ_API_KEYyes—Your crehq_live_… key
CREHQ_API_BASEnohttps://crehq.com/wp-json/crehq/v1Override API base (staging/proxy)
CREHQ_TIMEOUT_MSno30000Per-request timeout in ms
CREHQ_API_SURFACEnoautoAuto-detect sandbox vs full key; can be selfserve or full for debugging

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. For credit signals, FDD, site-selection criteria, contacts, provenance, change history, bulk data, whitespace, co-tenancy, or site timeline, call crehq_request_upgrade.
  • 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.
  • Self-serve guidance → whatever the API says about its own limits is passed through verbatim: the API's message, row_budget (used / limit / basis / reset), the full_dataset offer, upgrade_url / enterprise_url, did_you_mean slugs, and the markets a brand is served in. Successful self-serve calls lead with a short guidance block (coverage_note, total_available / has_more, row_budget, full_dataset, resolved_from, market_scope, and the Enhanced (D2) preview label, fields and note) ahead of the JSON rows.
  • 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 he

Nur der Anfang wird gezeigt; den Rest findest du im Repo