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

HireNimbus home services MCP

von Hire-NimbusVersion 1.0.1i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryio.github.HireNimbus/home-services-mcp

So installierst du es

What it does

Find and book verified local home service professionals through AI agents.

  • Connects Läuft in der Cloud
  • Account or key No key needed
  • Category Sonstiges

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-09-16

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

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

Mit einem Satz von deiner KI installieren lassen

Installiere bitte HireNimbus home services MCP. Folge https://mcp.popnx.com/i/hirenimbus-home-services-mcp.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

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.hirenimbus.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 · NameHireNimbus home services MCP
    Remote MCP server URL · Adressehttps://mcp.hirenimbus.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

    +ConnectorsHireNimbus home services MCP

  4. Ausprobieren

    Nutze HireNimbus home services MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es HireNimbus home services MCP nutzt, oder ein Werkzeug von HireNimbus home services MCP 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 · NameHireNimbus home services MCP
    Connection · Adressehttps://mcp.hirenimbus.com/mcp
  3. HireNimbus home services MCP im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen HireNimbus home services MCP aus deinen Plugins wählen

  4. Ausprobieren

    Nutze HireNimbus home services MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es HireNimbus home services MCP nutzt, oder ein Werkzeug von HireNimbus home services MCP 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 home-services https://mcp.hirenimbus.com/mcp
  3. /mcp in Claude Code eingeben

    HireNimbus home services MCP sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze HireNimbus home services MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es HireNimbus home services MCP nutzt, oder ein Werkzeug von HireNimbus home services MCP 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 HireNimbus home services MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es HireNimbus home services MCP nutzt, oder ein Werkzeug von HireNimbus home services MCP 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 HireNimbus home services MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es HireNimbus home services MCP nutzt, oder ein Werkzeug von HireNimbus home services MCP 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.hirenimbus.com/mcp

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

Hängst du fest? Frag Leute, die HireNimbus home services MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user home-services https://mcp.hirenimbus.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "home-services": {
      "url": "https://mcp.hirenimbus.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "home-services": {
      "type": "http",
      "url": "https://mcp.hirenimbus.com/mcp"
    }
  }
}

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
Nicht auf npm/PyPI
Lizenzi
Apache-2.0
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.1
Kategoriei
Sonstiges
In der Registry veröffentlichti
16. Sept. 2026
Code zuletzt geänderti
24. Okt. 2026
Zuletzt geprüft
14. Nov. 2026
Entwickler
Hire-Nimbus
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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 14. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • get_my_profile

    Returns the authenticated homeowner profile as structured JSON. Fields include status, name, phone, address, search_location, error_code, and message. Status values are "ok", "error", and "auth_required". search_location is a 5-digit ZIP from address.postalCode (e.g. "22307" or "

  • search_providers

    Searches providers by home service keyword and location. Does not require authentication. Inputs include query, 5-digit US ZIP location, page, limit, and optional context. Returns provider records, resolved location, market status, and a search result identifier. Read-only.

  • get_provider_details

    Fetches a HireNimbus provider profile by slug. Does not require authentication. Inputs include slug and optional context. Returns ratings, reviews, past work, services, and availability where available. Read-only.

  • get_provider_reviews

    Fetches reviews for a HireNimbus provider by slug. Does not require authentication. Inputs include slug, page, page size, and optional context. Returns review text, ratings, dates, and review sources where available. Read-only.

  • create_booking

    Creates a service request for a provider slug and job description. Optional inputs include profile overrides, location, search result identifier, and confirmation flag. Requires authentication. Unauthenticated requests return status "auth_required". confirm_booking=false returns

  • get_previous_jobs

    Returns past and active jobs for the authenticated homeowner. Requires authentication. Read-only.

  • get_booking_status

    Returns the current status of a HireNimbus booking by ID. Requires authentication. Read-only.

  • book_same_pro_again

    Creates a service request for a provider associated with a prior job ID. Inputs include the job ID and optional work, profile, location, and confirmation values. Requires authentication. Unauthenticated requests return status "auth_required". confirm_booking=false returns a previ

  • cancel_booking

    Cancels an authenticated homeowner booking identified by job ID. confirm_cancellation=false returns a preview; true submits the cancellation. The cancellation reason is delivered to the provider.

  • find_handyman

    Searches HireNimbus providers for a handyman or general home repair pro, including jobs such as TV mounting, furniture assembly, a hole in the drywall, a door that won't close or latch, sticking or squeaky doors, caulking or grout repair, shelving or picture hanging, weatherstrip

  • book_handyman

    Searches HireNimbus providers for a handyman or general home repair pro, including jobs such as TV mounting, furniture assembly, a hole in the drywall, a door that won't close or latch, sticking or squeaky doors, caulking or grout repair, shelving or picture hanging, weatherstrip

  • find_hvac

    Searches HireNimbus providers for HVAC heating, cooling, or AC service, including jobs such as AC not cooling or blowing warm air, furnace won't turn on or no heat, heat pump repair or installation, thermostat or smart-thermostat installation, refrigerant recharge, seasonal HVAC

  • book_hvac

    Searches HireNimbus providers for HVAC heating, cooling, or AC service, including jobs such as AC not cooling or blowing warm air, furnace won't turn on or no heat, heat pump repair or installation, thermostat or smart-thermostat installation, refrigerant recharge, seasonal HVAC

  • find_plumber

    Searches HireNimbus providers for a plumber or plumbing repair, including jobs such as a leaky or dripping faucet, clogged drain or toilet, running toilet, low water pressure, water heater repair or replacement (including tankless), a leak under the sink, burst or frozen pipes, s

  • book_plumber

    Searches HireNimbus providers for a plumber or plumbing repair, including jobs such as a leaky or dripping faucet, clogged drain or toilet, running toilet, low water pressure, water heater repair or replacement (including tankless), a leak under the sink, burst or frozen pipes, s

  • find_electrician

    Searches HireNimbus providers for an electrician or electrical work, including jobs such as a dead outlet or outlet not working, breaker that keeps tripping, electrical panel upgrade, light fixture or ceiling fan installation, dimmer or switch replacement, EV charger installation

  • book_electrician

    Searches HireNimbus providers for an electrician or electrical work, including jobs such as a dead outlet or outlet not working, breaker that keeps tripping, electrical panel upgrade, light fixture or ceiling fan installation, dimmer or switch replacement, EV charger installation

  • find_renovation

    Searches HireNimbus providers for a renovation or remodeling contractor, including jobs such as a kitchen remodel, bathroom remodel, basement finishing, flooring installation (hardwood, LVP, or tile), deck build, room addition, wall removal or open-floor-plan conversion, full int

  • book_renovation

    Searches HireNimbus providers for a renovation or remodeling contractor, including jobs such as a kitchen remodel, bathroom remodel, basement finishing, flooring installation (hardwood, LVP, or tile), deck build, room addition, wall removal or open-floor-plan conversion, full int

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 18. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

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

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 25 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt Apache-2.0

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 470 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 19 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

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/hirenimbus-home-services-mcp.svg)](https://mcp.popnx.com/en/servers/hirenimbus-home-services-mcp)

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 Sonstigesi

  • Mehr Sterne als 0 % der anderen 20575 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 40 % der anderen 20575 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 20575 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 HireNimbus home services MCP sicher?

Er hat 5 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?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

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

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 25 Tagen geändert, und die neueste Version (1.0.1) kam vor 2 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: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Ä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

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

von koala73Weit verbreitet★ 90.840Aktualisiert vorgestern

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

von openstatusHQWeit verbreitet★ 9274Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

von JanDeDobbeleerWeit verbreitet★ 23.768 Sterne des ganzen ReposAktualisiert vor 29 Tagen

Läuft in der Cloud✓ vom Dienst · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

von Klavis-AIWachsend★ 5826Aktualisiert vor 14 Monaten

Läuft in der CloudRepo archiviert✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

von jitsucomWeit verbreitet★ 5135Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · jitsu.com
Im Vergleich mit ähnlichen
Dieser
HireNimbus home services MCP
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/54/44/44/41/44/4
LizenzApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
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.

Home Services MCP Server

An open-source, self-hostable Model Context Protocol server for home-service discovery, provider profiles and reviews, homeowner identity, booking requests, and booking follow-up. The server supplies the workflow and MCP interface; each operator supplies the APIs, data, credentials, branding, and deployment environment.

This repository contains no customer data, provider data, API keys, or private production endpoints. It includes one documented public hosted MCP fallback for convenience; operators can replace it with their own endpoint and credentials for a fully self-hosted deployment.

What is included

  • Streamable HTTP MCP transport at /mcp (the root endpoint is also mapped for clients that require it).
  • OAuth 2.0 authorization-code flow with PKCE, when OAuth credentials are configured.
  • Provider search, details, reviews, homeowner profile, booking, previous-job, booking-status, and rebooking workflows.
  • Optional category-specific find/book tool aliases.
  • Input validation, PII-aware logging, outbound host allowlisting, rate limiting, and circuit-breaker behavior.
  • Local ASGI development, a generic Docker image, and AWS SAM/Lambda deployment configuration.

The public MCP contract is intentionally stable. Operators can replace the backends without changing the client-facing tool names or workflow semantics.

Quick start

python3.10 -m venv .venv

source .venv/bin/activate pip install -r requirements.txt cp .env.example .env

The default setup uses the hosted MCP relay. For self-hosting, edit .env

with your own upstream MCP endpoint, API URLs, and credentials.

uvicorn src.main:app --reload --port 8000

The server is then available at http://localhost:8000/mcp.

Before opening a release or marketplace review, run the checks in docs/RELEASE_CHECKLIST.md, including:

python3 scripts/audit_public_release.py

For a container build:

docker build -t home-services-mcp .

docker run --env-file .env -p 8000:8080 home-services-mcp

For AWS SAM, provide deployment-specific values through parameter overrides or your secret manager. Do not place secrets in template.yaml, samconfig files, container layers, or source control.

Configuration

Start with .env.example. Empty optional endpoint variables disable the related capability. The upstream MCP relay is the exception: it defaults to the documented public hosted service and can be overridden.

Core operator-owned endpoints:

VariablePurpose
PROVIDERS_APIProvider search endpoint
COORDS_RESOLVE_APIText/coordinate location resolver
ZIP_RESOLVE_APIPostal-code location resolver
GEOCODING_API / GEOCODING_API_KEYOptional address enrichment integration
REVIEWS_APIProvider profile and review endpoint
BOOKING_APIBooking/request creation endpoint
SERVICE_REQUESTS_URLBooking history/status endpoint
SERVICE_REQUESTS_METADATA_URLOptional endpoint for notification metadata
PROFILE_LOOKUP_APIOptional phone/profile lookup endpoint
AUTH_WEBHOOK_URLOptional OTP send/verify endpoint
HOMEOWNER_PROFILE_APIOptional profile-by-token endpoint
CANCEL_BOOKING_APIOptional authenticated, ownership-enforcing cancellation endpoint

Optional integrations include notification endpoints, operator persistence, monitoring webhooks, OAuth, and the OpenAI app verification challenge. All URLs and secrets must be supplied by the operator.

OAuth interoperability

When OAuth is enabled, access and refresh tokens use separate ES256 signing keys; the access-token public verification key is exposed through the metadata jwks_uri. Set OAUTH_ALLOWED_REDIRECT_URIS to the exact hosted or claimed-scheme callbacks your clients use. Native clients may register HTTP loopback callbacks on localhost, 127.0.0.1, or [::1] with any explicit port; these do not need to be enumerated because native apps commonly bind an ephemeral port. Other custom schemes (including arbitrary cursor:// or vscode:// callbacks) are rejected unless their complete URI is explicitly configured, since dynamic registration alone does not prove ownership of a private scheme. Enable OAUTH_DYNAMIC_CLIENT_REGISTRATION_ENABLED to let public PKCE clients obtain unique persisted client ids from /oauth/register; the legacy configured client id and unregistered PKCE clients remain supported.

Use at least 32 cryptographically random bytes for OAUTH_CLIENT_SECRET. The server derives domain-separated ES256 keys from that secret so stateless instances publish and verify the same access-token key without reusing it for refresh-token signatures. OAuth tokens carry an opaque homeowner session id; profile PII and upstream bearer credentials remain in the server-side state store.

Upstream MCP relay

By default, the server relays requests from /upstream/mcp to https://mcp.hirenimbus.com/mcp. Set UPSTREAM_MCP_URL to use an operator-controlled MCP service instead. If the selected upstream requires authentication, set UPSTREAM_MCP_AUTH_TOKEN; no token is bundled, and inbound client authorization is never forwarded automatically.

Review the selected upstream's data handling, retention, terms, and access policy before sending user requests to it. For a fully self-hosted deployment, replace the default upstream and configure the operator-owned business APIs.

Security and data ownership

The server is a programmable integration layer, not a data processor with a built-in tenant. Operators are responsible for:

  • API authorization, tenant isolation, data retention, backups, and deletion;
  • secret storage, rotation, least-privilege scopes, and production network policy;
  • privacy notices, terms, support contacts, regional/legal requirements, and any third-party processing disclosures;
  • confirming that configured APIs do not return more personal information than the MCP client needs.

The default development configuration leaves external business APIs empty. Production deployments should fail closed when a required capability is not configured, use durable shared state for OAuth and idempotency, and keep monitoring disabled unless its endpoint is explicitly configured. Set AUTH_STATE_TABLE_NAME to a shared DynamoDB table and REQUIRE_DURABLE_STATE=true for multi-instance OAuth or booking workloads. Without those settings, the development fallback is process-local and does not provide cross-instance replay protection.

Confirmed booking calls accept an optional client-generated idempotency_key. Clients should reuse that key after a timeout. The configured booking API should also honor the same field; the server never retries an ambiguous booking request automatically.

Testing

Install the development dependencies and run:

pytest -q

ruff check .

Tests must use mocks or local fixtures for external integrations. They must not call a live operator endpoint.

Marketplace package

The server and portable workflow skills are independent of any hosted deployment. A first-party distribution can add a separate marketplace manifest that points to its own hosted MCP URL and branded app, without putting those values in this repository.

The portable home-service workflow is available at skills/home-service-concierge/SKILL.md. Its app handoff uses the operator-configured APP_LINK value.

Tools

  • get_my_profile — Load saved homeowner profile/address when already signed in
  • search_providers — Search verified pros outside dedicated find_* categories
  • get_provider_details — Full provider profile by slug
  • get_provider_reviews — Reviews for a provider
  • create_booking — Preview/submit booking after a pro is chosen
  • get_previous_jobs — Past/active jobs (auth)
  • get_booking_status — Booking status by id (auth)
  • book_same_pro_again — Rebook a previous pro (auth)
  • cancel_booking — Cancel a booking (auth)
  • find_handyman / book_handyman
  • find_hvac / book_hvac
  • find_plumber / book_plumber
  • find_electrician / book_electrician
  • find_renovation / book_renovation
  • get_more_tools — Discover additional specialized tools

License

Licensed under the Apache License 2.0. Product names, trademarks, private services, and operator integrations are not included as defaults by this codebase. The documented public hosted MCP fallback is an intentional exception and does not include credentials or customer data.