Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

CREHQ Location Intelligence

de groundroofversión 0.1.7i★ 0iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.groundroof/crehq-mcp-server

Cómo instalar

What it does

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

  • Connects Computadora o nube
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs CREHQ_API_KEY
  • Category Viajes, mapas y clima

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad7/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso15/100

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala CREHQ Location Intelligence. Sigue https://mcp.popnx.com/i/groundroof-crehq-mcp-server.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.crehq.com) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreCREHQ Location Intelligence
    Remote MCP server URL · Direcciónhttps://mcp.crehq.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsCREHQ Location Intelligence

  4. Pruébalo

    Usa CREHQ Location Intelligence y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando CREHQ Location Intelligence o muestra una herramienta de CREHQ Location Intelligence en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreCREHQ Location Intelligence
    Connection · Direcciónhttps://mcp.crehq.com/mcp
  3. Elige CREHQ Location Intelligence en un chat

    Abre un chat nuevo y elige CREHQ Location Intelligence en tus plugins antes de escribir

  4. Pruébalo

    Usa CREHQ Location Intelligence y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando CREHQ Location Intelligence o muestra una herramienta de CREHQ Location Intelligence en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

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

    Deberías ver CREHQ Location Intelligence en la lista como conectado

  4. Pruébalo

    Usa CREHQ Location Intelligence y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando CREHQ Location Intelligence o muestra una herramienta de CREHQ Location Intelligence en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa CREHQ Location Intelligence y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando CREHQ Location Intelligence o muestra una herramienta de CREHQ Location Intelligence en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa CREHQ Location Intelligence y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando CREHQ Location Intelligence o muestra una herramienta de CREHQ Location Intelligence en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.crehq.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa CREHQ Location Intelligence💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
    }
  }
}

Instalado en tu computadora

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"
      }
    }
  }
}

Valores que debes completar

  • CREHQ_API_KEY secreto obligatorio env
    Tu clave de API de CREHQ. Obtén una clave de sandbox gratuita en https://crehq.com/developers/sandbox/.
    Ver original en inglésYour CREHQ API key. Get a free sandbox key at https://crehq.com/developers/sandbox/.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
57/sem
Licenciai
Sin licencia indicada
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.7
Publicado en el registroi
11 jul 2026
Último cambio de códigoi
14 oct 2026
Última revisión
15 nov 2026
Creador
groundroof
Paquetes
npm: crehq-mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub groundroof, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 36 días

  • ! Precaución

    Tiene licencia

    GitHub no pudo identificar el tipo de licencia; abre el archivo para comprobarlo

  • ✓ Superada

    El endpoint responde

    Respondió en 69 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para crehq-mcp-server@0.1.7

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Viajes, mapas y climai

  • Más estrellas que el 0% de los otros 2025 servidores de esta categoría
  • Publicado en el registro más recientemente que el 13% de los otros 2025 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 63% de los otros 2025 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro CREHQ Location Intelligence?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: CREHQ_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 36 días, y la última versión (0.1.7) llegó al registro hace 4 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Mu

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

de microEn crecimiento★ 440Actualizado hace 4 meses

Se ejecuta en la nube✓ micro.mu

Killbottleneck

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

de tengolabsInicial↓ 328/sem★ 14Actualizado hace 12 días

Se ejecuta en tu computadora✓ del servicio · killbottleneck.com

Whimsical

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

de WhimsicalCodeInicial★ 11Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · whimsical.com
Comparado con otros parecidos
Este
CREHQ Location Intelligence
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoNoSí
Revisiones básicas4/54/43/33/34/44/4
LicenciaNOASSERTIONAGPL-3.0MITMITMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo