# Golf Brothers MCP server

This is a read-only Model Context Protocol (MCP) server exposing the Golf
Brothers golf equipment catalog to AI assistants. Transport: streamable HTTP,
stateless JSON-RPC 2.0 over POST to this URL. No authentication required.

## How to connect
- Claude: Settings -> Connectors -> Add custom connector -> https://www.golfbrothers.de/mcp
- ChatGPT: enable Developer mode, add remote MCP server https://www.golfbrothers.de/mcp
- Any MCP client: POST JSON-RPC 2.0 messages (initialize, tools/list, tools/call).

## Tools
- search_products — Full-text search over the product catalog (also matches categories and brands). Returns name, price incl. VAT, availability, absolute product URL and image.
- get_product — Full detail of one product by numeric id: localized name, EAN, price incl. VAT, list price, variants (sizes/colors) with their prices, stock, canonical URL.
- get_availability — Check exact SKU orderability, own sellable stock, replenishment permission, quantity caps and estimated lead time. Not a reservation or guaranteed supplier ATP; in_stock means own stock only.
- get_policies — Commerce policies for a market: return window (days), who pays return shipping, delivery time, shipping rate and free-shipping threshold.

Markets: cz, de, pl, eu, es, fr, it, nl, se, sk (pass `market`; prices include
VAT in the market currency). Purchases happen on the shop website — link the
customer to the product `url` returned by the tools.

## Example
curl -X POST https://www.golfbrothers.de/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"ecco 43","market":"cz"}}}'

More machine-readable entry points: https://www.golfbrothers.de/llms.txt