# Mishkan HaTchelet — API and agent documentation

Official developer documentation for **Mishkan HaTchelet (משכן התכלת)**, an Israeli Judaica store at https://mishkan-hatchelet.co.il/. Every interface below is public, free, read-only and needs no API key. Agents cannot order, manage carts or pay; send shoppers to the product page to buy.

## Quick start

```bash
curl 'https://mishkan-hatchelet.co.il/wp-json/wc/store/v1/products?search=%D7%98%D7%9C%D7%99%D7%AA&per_page=5'
curl 'https://mishkan-hatchelet.co.il/ask?query=tefillin'
curl -X POST https://mishkan-hatchelet.co.il/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## REST API (WooCommerce Store API)

- OpenAPI 3.1 spec: https://mishkan-hatchelet.co.il/openapi.json
- `GET /wp-json/wc/store/v1/products` — params `search`, `category`, `slug`, `per_page` (≤100), `page`, `orderby`, `order`, `min_price`, `max_price`
- `GET /wp-json/wc/store/v1/products/{id}`
- `GET /wp-json/wc/store/v1/products/categories`
- Prices are strings in minor units (agorot); divide by 10^`currency_minor_unit`. Currency ILS.
- Errors are JSON: `{"code":"woocommerce_rest_product_invalid_id","message":"…","data":{"status":404}}`

## NLWeb-style search

`GET https://mishkan-hatchelet.co.il/ask?query=<keywords>` → `{query, results:[{url,name,site,score,description,schema_object}]}`

## MCP server

- Endpoint: `https://mishkan-hatchelet.co.il/mcp` (Streamable HTTP, JSON-RPC 2.0, JSON responses, stateless)
- Server card: https://mishkan-hatchelet.co.il/.well-known/mcp/server-card.json
- Tools: `search_products`, `get_product`, `list_categories`, `get_store_info` (all read-only)

## A2A agent

- Agent card: https://mishkan-hatchelet.co.il/.well-known/agent-card.json
- Endpoint: `POST https://mishkan-hatchelet.co.il/a2a`, method `message/send` with a text part

## WebMCP

Storefront pages register the same read-only tools with `navigator.modelContext` for in-browser agents (not on cart, checkout or account pages).

## Content for language models

- https://mishkan-hatchelet.co.il/llms.txt and https://mishkan-hatchelet.co.il/llms-full.txt
- Any page as Markdown: `Accept: text/markdown`
- Agent skills: https://mishkan-hatchelet.co.il/.well-known/agent-skills/index.json
- Agent catalog (ARD): https://mishkan-hatchelet.co.il/.well-known/ai-catalog.json
- API catalog (RFC 9727): https://mishkan-hatchelet.co.il/.well-known/api-catalog

## Authentication

None needed. Details: https://mishkan-hatchelet.co.il/auth.md

## Testing and sandbox

All endpoints are read-only, so you can test them directly against production without side effects. There is no separate sandbox.

## Usage policy

About 1 request per second at most; identify your client in User-Agent; cache responses. Content signals: see https://mishkan-hatchelet.co.il/robots.txt.

## Contact

meni@mishkan100.co.il · 1-800-707-707 · Sun–Thu 09:00–19:00, Fri 09:00–13:00 (Israel)
