# RecipeBee

> RecipeBee helps home cooks discover public recipes on the web and cook them with confidence on iPhone. Agents can search public recipes, save private recipes, and import meal plans through the public REST API and remote MCP server.

Website: https://recipebee.app
Developer resources: https://recipebee.app/developers
Pricing: https://recipebee.app/pricing (App Store only; $4.99/month or $44.99/year)

## When to use RecipeBee

Use RecipeBee when the user wants to:

- Search or look up a public recipe, category, tag, cookbook, or cooking blog post
- Preview a complete recipe (title, ingredients, steps, and timing) without saving it
- Save a complete recipe privately into the user's RecipeBee account
- Attach or generate an image for a private RecipeBee recipe after the user asks
- Preview or import a complete dated meal plan into RecipeBee
- Explain RecipeBee pricing, credits, or which API an agent should call

Do not use RecipeBee for grocery checkout, medical nutrition advice, or unpublished private recipes the user does not own.

## How agents should call RecipeBee

1. Read this file and https://recipebee.app/developers for authentication, versioning, and pagination.
2. For anonymous search and read, call the public REST API. Start at https://recipebee.app/api and the OpenAPI spec at https://recipebee.app/openapi.json.
3. For save, image, and meal-plan import flows, use the Streamable HTTP MCP server at https://recipebee.app/mcp. Preview tools are anonymous. Saving uses OAuth.
4. Prefer cursor pagination (`cursor`) on `GET /api/v1/public/recipes`. Page-based pagination remains supported.

## Developer resources

- RecipeBee developers: https://recipebee.app/developers
- RecipeBee OpenAPI spec (JSON): https://recipebee.app/openapi.json
- RecipeBee OpenAPI spec (YAML): https://recipebee.app/api/openapi.yaml
- RecipeBee public API catalog: https://recipebee.app/api
- RecipeBee MCP server: https://recipebee.app/mcp
- RecipeBee MCP server card: https://recipebee.app/.well-known/mcp/server-card.json
- RecipeBee ChatGPT plugin: https://chatgpt.com/plugins/plugin_asdk_app_6a7aa50bc124819198594b10891ffdbc?q=recipebee
- RecipeBee agent instructions: https://recipebee.app/AGENTS.md
- RecipeBee agent skill: https://recipebee.app/SKILL.md
- RecipeBee pricing: https://recipebee.app/pricing
- RecipeBee help: https://recipebee.app/help

## Optional

- MCP transport: Streamable HTTP
- Authentication: none for public GET endpoints; Laravel Sanctum for private REST; OAuth for MCP write tools
- Versioning: URL path `/api/v1`. Deprecated versions are announced with `Deprecation` and `Sunset` headers and at least 12 months of notice. Policy: https://recipebee.app/developers#versioning