BlindsBazaar MCP server
A Model Context Protocol 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:
- The hosted URL (recommended) —
https://api.blindsbazaar.in/mcp(Streamable HTTP). Nothing to install; seedeploy/HOSTING.mdfor the systemd + nginx setup. - 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.
Local stdio (for Claude Desktop / Claude Code / pi / Cursor):
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):
[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 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 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). Bumpversiontogether withpyproject.toml..github/workflows/publish-mcp.yml— publishes to PyPI on everyv*tag (PyPI trusted publishing; one-time setup: on pypi.org add a pending publisher — OwnerKumar-vikalp, repoblindsbazaar, workflowpublish-mcp.yml, environmentpypi).
Steps:
- Publish to PyPI —
git tag v0.1.0 && git push origin v0.1.0(after the one-time trusted-publisher setup), orcd mcp && uv build --wheel && uv publishlocally. - 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. - 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_blindPOSTs 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.mdincludes 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.
Metadata
Release files for blindsbazaar-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| blindsbazaar_mcp-0.1.0.tar.gz | 61.7 kB | Without provenance | Details for blindsbazaar_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| blindsbazaar_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for blindsbazaar_mcp-0.1.0-py3-none-any.whl |
Total release size: 73.0 kB
Release files / blindsbazaar_mcp-0.1.0.tar.gz
| Download URL | blindsbazaar_mcp-0.1.0.tar.gz |
|---|---|
| Size | 61.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
34b6dfc48b0f74fe9b3b48e18f26702e6fe692cf70d8aecc479517be1eb4419f
|
|
BLAKE2b-256 checksum How to use checksums |
979c7a3acdbcdeda6d9a74ebb90f853bd5c76072af52c96549d9e0fca1ef1a88
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / blindsbazaar_mcp-0.1.0-py3-none-any.whl
| Download URL | blindsbazaar_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6eeef9f0769d713b6e31e910517655e842fc5ba33449b4bb674448256f36add0
|
|
BLAKE2b-256 checksum How to use checksums |
3e163d1848667dd89ca1a60ce464ff7abc7967c202814996e51707b54f644e04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for blindsbazaar-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.