bhs-mcp
Allows deploying the MCP server as a Cloudflare Worker, leveraging Cloudflare's edge network for low-latency access to product data from Blackhearts & Sparrows.
Enables querying Blackhearts & Sparrows product data via GraphQL APIs for flexible and efficient data retrieval.
Provides integration with Meilisearch for fast, typo-tolerant product search capabilities within the BHS product catalog.
Allows executing TypeScript code in a sandboxed environment to interact with the BHS API, including product search, store listing, and cart management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bhs-mcpsearch for red wines under $30"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bhs-mcp
MCP server for Blackhearts & Sparrows product data, deployed as a Cloudflare Worker.
Uses the Code Mode pattern — the LLM writes TypeScript that executes against a typed BHS API in a sandboxed Dynamic Worker, rather than calling fixed tools directly.
Architecture
LLM -> code tool -> Dynamic Worker (sandbox)
| bhs.search(...)
BhsProxy (RPC bridge)
|
Host Worker
|
Meilisearch / GraphQL APIsThe sandbox has no network access. All external calls go through the BhsProxy RPC bridge to the host worker.
Related MCP server: Angular Bootstrap MCP Server
MCP Tools
Tool | Description |
| TypeScript type definitions, method signatures, and example queries |
| Sandbox capabilities, constraints, and guidance |
| Execute TypeScript with access to the |
Sandbox API
// Search products
const wines = await bhs.search({ type: "Wine", country: "France", priceMax: 30 });
// Get product details
const product = await bhs.product("44253");
// List stores
const stores = await bhs.stores();
// Manage cart
const cart = await bhs.cart.create();
await bhs.cart.addItems(cart.uid, [{ sku: "44253", masterSku: "44253", quantity: 6 }]);
const url = bhs.cart.checkoutUrl(cart.uid);Development
npm install
npm run dev # wrangler dev
npm run typecheck # tsc --noEmit
npm run deploy # wrangler deployDeployment
Route: bhs.jackemcpherson.com/mcp*
Depends on @jackemcpherson/bhs-cli for API functions and types.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP server that enables LLMs to understand and work with TypeScript APIs they haven't been trained on by providing structured access to TypeScript type definitions and documentation.Last updated5046MIT
- Alicense-qualityDmaintenanceA TypeScript-based MCP server that provides backend API handling and facilitates communication between microservices. Features an organized structure with controllers, routes, and models for easy extensibility and maintenance.Last updated3051MIT
- FlicenseBqualityDmaintenanceA code-first MCP server that provides a single tool to execute JavaScript or TypeScript with authenticated access to Google Workspace APIs. It enables flexible interactions with services like Calendar and Drive by running user-provided scripts through a built-in runtime environment.Last updated17
- Alicense-qualityDmaintenanceDeprecated MCP server integrating with Kibo Commerce for product, order, customer, and inventory management via its TypeScript SDK.Last updated17MIT
Related MCP Connectors
Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
An MCP server for Arcjet - the runtime security platform that ships with your AI code.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jackemcpherson/bhs-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server