Connection
| Endpoint | https://connect.fortpointbeer.com/mcp |
| Protocol | MCP over Streamable HTTP (JSON-RPC 2.0) |
| Auth | None required |
| Health check | GET /health |
| Session mode | Stateless — no persistent sessions between requests |
Architecture
Fort Point Connect is a Rails app that acts as an MCP server. It wraps the Shopify Storefront API and Shopify's own MCP endpoint, adding custom tools for shipping, brewery info, and beer recommendations.
The server dynamically discovers Shopify's MCP tools at boot and proxies them through, so clients get Fort Point's custom tools and Shopify's commerce tools from a single endpoint. Cart attribution (source: claude-mcp) is injected automatically on cart updates.
recommend_beer
Pulls the live Fort Point Beer Company product catalog from the Shopify Storefront API. Filters to Fort Point beer and cider only, checks variant-level inventory, and returns what's actually in stock with descriptions and pricing. The model is instructed to research the beers online for tasting notes, reviews, and food pairings.
| Param | Type | Req | Description |
|---|---|---|---|
| query | string | yes | What the person is looking for — mood, occasion, style, flavor preferences, beer comparisons, dietary needs, or "show me everything" |
| exclude_alcohol | boolean | no | Set true for non-alcoholic options only |
Returns a formatted catalog with product names, descriptions, types, and prices. Only includes products with quantityAvailable > 0 at the variant level — Shopify's product-level availableForSale flag is not reliable for inventory status.
check_delivery
All-in-one shipping tool. Accepts a ZIP code, a state, or neither — and returns the right level of detail for each.
| Param | Type | Req | Description |
|---|---|---|---|
| zip_code | string | no | ZIP code for live carrier rates and delivery timing (via Camber) |
| state | string | no | US state code for eligibility check (e.g. CA, NY) |
| has_alcohol | boolean | no | Whether the order contains alcohol (default: true) |
With a ZIP code: calls the Camber carrier service for live rates (same rates Shopify checkout uses). With a state: returns eligibility and general pricing. With nothing: returns a full shipping policy overview.
get_brewery_info
Returns Fort Point Beer Company locations, hours, tap lists, and background. No parameters.
| Param | Type | Req | Description |
|---|---|---|---|
| No parameters | |||
Shopify Proxy Tools
These tools are discovered from Shopify's MCP endpoint at server boot and proxied through Fort Point Connect. They handle catalog search, cart management, and store policies.
| Tool | Description |
|---|---|
| search_shop_catalog | Search the Fort Point Beer Company product catalog by keyword. Returns beers, NA options, and merch with buy links. |
| get_cart | Retrieve the current cart contents and checkout URL. |
| update_cart | Add, remove, or change items in the cart. Automatically sets source: claude-mcp for order attribution. |
| search_shop_policies_and_faqs | Search store policies, shipping info, and FAQs. |
Proxy tool schemas are defined by Shopify and may change. Use tools/list to get the current definitions.
Prompts
beer_recommendation
Kicks off a beer recommendation flow. Calls recommend_beer under the hood to pull the live catalog.
| Param | Type | Req | Description |
|---|---|---|---|
| preferences | string | yes | What you're in the mood for (e.g. "light and crispy", "hoppy IPA", "something for tacos") |
gift_pack_builder
Helps put together a Fort Point beer gift for a specific occasion.
| Param | Type | Req | Description |
|---|---|---|---|
| occasion | string | yes | The occasion (e.g. "birthday", "housewarming", "holiday") |
| budget | string | no | Budget in dollars (e.g. "50" or "75-100") |
order_beer
Walks through the full ordering flow — delivery check, catalog browse, cart, and checkout.
| Param | Type | Req | Description |
|---|---|---|---|
| location | string | yes | Delivery address, city, state, or ZIP code |
Resources
| URI | Description |
|---|---|
| fort-point://beers | Full Fort Point Beer Company product catalog as JSON. Pulled from the Shopify Storefront API, cached 5 minutes. |
| fort-point://beers/{slug} | Single product by handle (e.g. fort-point://beers/ksa-kolsch) |
Business Rules
- Alcohol (beer and cider) ships to California only. 21+ government-issued photo ID required at delivery.
- Non-alcoholic beer and merch ship to most of the US via UPS ground.
- Free shipping on orders $70+. Beer Club members always get free shipping.
- Brewery pickup available at 742 Valencia St, San Francisco.
- Only Fort Point Beer Company products are recommended. Other brands in the Shopify catalog are filtered out.
- Inventory is checked at the variant level. Products with zero stock are excluded from recommendations even if Shopify reports them as available.