Metadata-Version: 2.5
Name: blindsbazaar-mcp
Version: 0.1.0
Summary: Read-only MCP server for the BlindsBazaar storefront: live catalog, authoritative window-price quotes, FAQs, buying guides and delivery info.
Project-URL: Homepage, https://blindsbazaar.in/mcp/
Project-URL: Repository, https://github.com/Kumar-vikalp/blindsbazaar
Project-URL: Issues, https://github.com/Kumar-vikalp/blindsbazaar/issues
Author: BlindsBazaar
License: MIT
Keywords: blinds,blindsbazaar,e-commerce,llm-tools,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<2,>=1.2.0
Requires-Dist: uvicorn>=0.30
Description-Content-Type: text/markdown

# BlindsBazaar MCP server

A [Model Context Protocol](https://modelcontextprotocol.io) server that exposes the
BlindsBazaar storefront — live catalog, authoritative pricing, FAQs, journal content and
delivery policies — to MCP clients (Claude Desktop, Claude Code, Codex CLI, Cursor, ChatGPT
connectors, pi, …).

**Distributed without sharing any source code.** Consumers get one of:

1. **The hosted URL** (recommended) — `https://api.blindsbazaar.in/mcp` (Streamable HTTP).
   Nothing to install; see `deploy/HOSTING.md` for the systemd + nginx setup.
2. **The PyPI package** — `pip install blindsbazaar-mcp` / `uvx blindsbazaar-mcp`.
   Publish with the included GitHub Actions workflow (see below).

No secrets ship with either: every tool calls the public storefront API, and there is
**no write access** — no tool can place orders, edit products or touch accounts.

## Tools

| Tool | What it does |
|---|---|
| `search_products` | Search/filter the catalog (text, blind type, room, collection, opacity, price cap) |
| `get_product` | Full detail: prices, size ranges, materials, photos, colourways, ratings |
| `quote_blind` | Price an exact window size — calls the store's own pricing engine (the same one checkout charges) |
| `list_blind_types` | Blind types + rate card (₹/sq ft, minimum charge, motorizable) |
| `list_rooms` / `list_collections` | Taxonomy slugs for filtering, plus storefront URLs |
| `get_configurator_options` | Minimum billable area + fabric/control/mount options with ₹ add-ons |
| `search_faqs` / `search_journal` / `get_journal_story` | The store's own FAQs and buying guides |
| `delivery_coverage` | Where/how orders are delivered, making + transit times, self-install policy |

## Run it

**Hosted (no install for consumers):** point the client at the URL —
`https://api.blindsbazaar.in/mcp`. Hosting setup: [`deploy/HOSTING.md`](deploy/HOSTING.md).

**Local stdio (for Claude Desktop / Claude Code / pi / Cursor):**

```bash
uvx blindsbazaar-mcp          # once published to PyPI
# or, from this folder:
uv run blindsbazaar-mcp
```

| Variable | Default | Purpose |
|---|---|---|
| `BLINDSBAZAAR_API_URL` | `https://api.blindsbazaar.in/api/v1` | Point at a local backend (`http://localhost:8001/api/v1`) while developing |
| `BLINDSBAZAAR_SITE_URL` | `https://blindsbazaar.in` | Base used for the page URLs returned in tool output |
| `BB_MCP_TRANSPORT` | `stdio` | `streamable-http` to host |
| `BB_MCP_HOST` / `BB_MCP_PORT` / `BB_MCP_PATH` | `127.0.0.1` / `8817` / `/mcp` | HTTP hosting bind |

## Client configuration

**Claude Code:** `claude mcp add --transport http blindsbazaar https://api.blindsbazaar.in/mcp`
(or stdio: `claude mcp add blindsbazaar -- uvx blindsbazaar-mcp`)

**Codex CLI** (`~/.codex/config.toml`):

```toml
[mcp_servers.blindsbazaar]
url = "https://api.blindsbazaar.in/mcp"   # remote; or command/args for stdio
```

**Claude Desktop:** Settings → Connectors → Add custom connector → the URL
(or the stdio `mcpServers` JSON in `claude_desktop_config.json` — see the
[storefront setup page](https://blindsbazaar.in/mcp/) for every client).

## Get listed in the MCP ecosystem

The old `modelcontextprotocol/servers` README list is frozen — it now only hosts
reference implementations. Discovery happens through the
**[official MCP Registry](https://registry.modelcontextprotocol.io/)** plus directory
sites (PulseMCP, Smithery, Glama, mcp.so). This folder ships everything needed:

- `server.json` — the registry descriptor (`io.github.Kumar-vikalp/blindsbazaar`,
  the hosted remote URL and the PyPI package). Bump `version` together with `pyproject.toml`.
- `.github/workflows/publish-mcp.yml` — publishes to PyPI on every `v*` tag
  (PyPI trusted publishing; one-time setup: on pypi.org add a pending publisher —
  Owner `Kumar-vikalp`, repo `blindsbazaar`, workflow `publish-mcp.yml`,
  environment `pypi`).

Steps:

1. **Publish to PyPI** — `git tag v0.1.0 && git push origin v0.1.0` (after the one-time
   trusted-publisher setup), or `cd mcp && uv build --wheel && uv publish` locally.
2. **Submit to the official registry** — sign in at registry.modelcontextprotocol.io
   with GitHub and submit `server.json`. Note: `io.github.*` names are validated against
   the GitHub repo — if this repo becomes private, prove domain control instead and
   register under the blindsbazaar.in name.
3. **Optional directories** — PulseMCP, Smithery and Glama accept community submissions
   and are how most users browse; submit the same descriptor there.

## Architecture notes

- **Read-only by design.** There is deliberately no order/account tool: those endpoints need
  customer tokens and would turn a chat assistant into something that can spend money. If that
  is ever wanted, it should be a separate, authenticated, opt-in server.
- **Pricing is never reimplemented client-side.** `quote_blind` POSTs to
  `/api/v1/configurator/quote/` — the endpoint the storefront configurator uses — so the cart,
  the site and this server can never quote different numbers.
- The hosted HTTP endpoint is **stateless** and proxies only public data; `deploy/HOSTING.md`
  includes an nginx rate-limit block so a script can't hammer the API through it.
- **Source-visibility note:** a PyPI *wheel* contains readable Python; the package ships only
  this thin public-API wrapper — no backend, CRM or business code. The hosted URL is the
  distribution mode that shares nothing at all.
