Skip to main content

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:

  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.

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). 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.

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)

Source distribution for blindsbazaar-mcp 0.1.0
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)

Table of built distributions (wheels) for blindsbazaar-mcp 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page