# מפתחים מחוץ לקופסה - agent integration guide

## When to use this site

Use this service when a user asks what the podcast covered about a technology or engineering practice, wants an episode featuring a guest, or needs a meetup talk or YouTube link. The catalogue content is in Hebrew.

## Fastest route

Use the content MCP server at `https://outside-the-box.dev/mcp`. Start with `search_podcast` for topic questions. Use `list_episodes`, `list_talks`, or `list_speakers` to browse. Every tool is read-only.

## REST alternative

The public JSON API starts at `https://outside-the-box.dev/api/v1`. Its complete contract is [OpenAPI 3.1](https://outside-the-box.dev/openapi.json). Search uses `GET /api/v1/search?q={query}`; list responses use cursor pagination.

## Constraints

No authentication is required. Do not request or send credentials. Respect the RateLimit response headers and retry a 429 only after `Retry-After`. There are no write operations.

## Source and documentation

The public [source repository](https://github.com/shahar84/outside-the-box-website) contains AGENTS.md and the implementation context for coding agents. For integration questions, use the documentation MCP server at `https://outside-the-box.dev/docs/mcp` or read [the developer portal](https://outside-the-box.dev/developers).