nobrokerhood-mcp

A CLI and MCP server for pre-approving deliveries and visitors at your gate via the NoBrokerHood resident app — so you (or an LLM on your behalf) can say "let the Zepto guy in" instead of opening the app.

This is an unofficial client. It is not affiliated with or endorsed by NoBrokerHood.

Install

pip install git+https://github.com/smtchahal/nobrokerhood-mcp.git

(Not yet published to PyPI.)

Authentication

There's no OAuth flow — the client authenticates the same way the mobile app does, with a captured session. Proxy the NoBrokerHood app once (e.g. with mitmproxy or Charles Proxy) and pull the following out of a request:

• NBH_USER_ID, NBH_SOCIETY_ID, NBH_DEVICE_ID — from the userId / societyId / deviceId request headers
• NBH_REMEMBER_ME, NBH_JSESSIONID — from the remember-me / JSESSIONID cookies

Copy .env.example to .env and fill these in (or export them directly — the client reads plain environment variables, nothing loads .env for you).

These sessions are long-lived but not eternal; if you start getting auth errors, recapture them.

CLI usage

nbh pre-approve zepto --apartment-id <id>
nbh pre-approve dominos --apartment-id <id> --hours 4
nbh pre-approve amazon --apartment-id <id> --out "25/04/2026 23:59" --vehicle TWO_WHEELER
nbh cancel <visit-id> --apartment-id <id>
nbh list --apartment-id <id>
nbh visits --apartment-id <id>
nbh user-info

Run nbh <command> --help for the full flag list. ~100 delivery brands (Zepto, Blinkit, Swiggy, Dominos, Amazon, couriers, home services, ...) have built-in default approval windows — see nobrokerhood.companies.KNOWN_COMPANIES. Unknown brands default to a 1-hour window.

MCP server

Registers six tools: pre_approve, cancel_visit, list_expected, list_visits, get_user_multiprofile_info, known_companies.

Add to your MCP client config (e.g. .mcp.json for Claude Code):

{
  "mcpServers": {
    "nobrokerhood": {
      "command": "nobrokerhood-mcp",
      "env": {
        "NBH_USER_ID": "...",
        "NBH_SOCIETY_ID": "...",
        "NBH_DEVICE_ID": "...",
        "NBH_REMEMBER_ME": "...",
        "NBH_JSESSIONID": "..."
      }
    }
  }
}

This runs the server over stdio with no authorization layer — appropriate for local use, where the MCP client is the only thing that can spawn the process.

Self-hosting over HTTP

If you want to expose this server remotely (e.g. behind a tunnel, for use from claude.ai instead of a local client), nobrokerhood.server exposes a build_server() factory instead of a fixed server instance, so you can bring your own authorization:

from nobrokerhood.server import build_server

mcp = build_server(
    host="0.0.0.0",
    port=8000,
    streamable_http_path="/mcp",
    token_verifier=my_token_verifier,  # implement mcp.server.auth.provider.TokenVerifier
    auth=my_auth_settings,  # mcp.server.auth.settings.AuthSettings
)
mcp.run(transport="streamable-http")

This package intentionally does not ship an authorization implementation — how you authenticate callers to your server is a separate concern from how this client authenticates to NoBrokerHood.

Library usage

from nobrokerhood import NobrokerhoodClient

client = NobrokerhoodClient()  # reads NBH_* env vars
client.pre_approve("Zepto", apartment_id="...")

See nobrokerhood/client.py for the full API (pre_approve, cancel_visit, list_expected, list_visits, register_device, get_user_multiprofile_info, get_home_content).

Development

pip install -e ".[dev]"
pre-commit install
pytest

License

MIT — see LICENSE.