# Deali - Developer & API area

> Scoped index for the deali.co.il developer surface: the free read-only REST API, the MCP server, OpenAPI spec, authentication (none), and agent skills. For the full site index see https://www.deali.co.il/llms.txt.

## API (free, no auth)

- OpenAPI 3.1 spec: https://www.deali.co.il/openapi.json
- `GET /api/site/deals` - full curated catalog as JSON (ILS prices, discount, rating, image, affiliate buy link)
- `GET /api/site/product-detail?id=<id>` - live product enrichment
- `GET /api/site/blog` - Hebrew blog list; `?id=<slug>` for one article
- `POST /ask` `{"query":"..."}` - NLWeb natural-language search (SSE streaming with `prefer.streaming: true`)
- Errors are JSON: `{ "error": "<message>" }` with an appropriate HTTP status.

## MCP (Model Context Protocol)

- Endpoint (Streamable HTTP, no auth): https://www.deali.co.il/mcp
- Server card: https://www.deali.co.il/.well-known/mcp/server-card.json
- Tools: search_deals, get_product, list_blog_posts, get_blog_post
- Add to Claude Code: `claude mcp add --transport http deali https://www.deali.co.il/mcp`
- Browser agents: WebMCP tools are exposed in-page (see the homepage `<script>` registering window.mcp tools).

## Authentication

None. No key, no token, no OAuth flow. Machine-readable confirmation:
- https://www.deali.co.il/auth.md
- https://www.deali.co.il/.well-known/oauth-protected-resource
- https://www.deali.co.il/.well-known/oauth-authorization-server

## Discovery

- Developer portal (human): https://www.deali.co.il/developers
- API catalog (RFC 9727): https://www.deali.co.il/.well-known/api-catalog
- Agent skills index: https://www.deali.co.il/.well-known/agent-skills/index.json
- A2A agent card: https://www.deali.co.il/.well-known/agent-card.json
- AI manifest: https://www.deali.co.il/.well-known/ai.json
- Agent config repo (AGENTS.md + SKILL.md): https://github.com/deali-prod