MenuFresh

この接続（あなたのアカウント）で操作できる店舗の一覧を返す。複数店舗を運営している場合に使う。各店舗のID・名前・役割・AI連携の有無（aiEnabled）・現在のアクティブ店舗かを返す。別の店舗を操作したいときは、各ツールの restaurant_id にここで得た店舗IDを渡す。AI連携OFFの店舗（非Proなど）は操作できない。

mf_list_stores

当期と前期（同じ長さ）を比べ、利益・粗利率の異変を検知する（読み取り）。全体の利益/粗利の増減に加え、粗利率が大きく落ちた料理・赤字に転じた料理を一覧で返す。毎朝のブリーフィングや『最近おかしい数字ある？』に。Square連携が必要。

mf_anomalies

料理の原価ソース(食材/レシピ/手動)を設定する。action=set(1料理の本体原価を置換)/ add_to_many(複数料理に同じ原価ソースを“追加”・非置換)/ copy(ある料理の原価行を別の料理へコピー)。サイズ別原価は mf_dish(set_sizes)、原価率の確認は mf_cost。

mf_dish_cost

料理の“魅力の素材”を実データから返す（インスタ/SNS/メニュー説明文づくり用）。料理名・キャッチ・既存の説明文・カテゴリ・売価・アレルゲン・主な食材/構成・作り方の見どころ・ベジ/低カロリー等を返す。AIはこれを元に、**嘘のない（実在する食材・作り方に基づく）紹介文**を書ける。食材や効能を勝手に作らないこと。書いた文をそのまま反映したいときは mf_dish(action='update') の description/tagline を使う。

mf_dish_story

料理(メニュー)の登録・編集。action=add(新規作成・既定は非公開)/ update(名前・売価・公開/非公開・売り切れ等)/ delete(削除・confirm要)/ bulk_update(複数を一括: 公開・売価±%等。confirmで件数提示)/ set_sizes(並/大盛などのサイズ展開)。原価ソースは mf_dish_cost、紹介文ネタは mf_dish_story、原価率は mf_cost。

mf_dish

実地棚卸しを記録する。数えた食材と数量を lines で渡す（数えた分だけの部分棚卸しも可）。**まず confirm 無し（下書き）で呼ぶ**と、各行を台帳の食材へ名寄せし、単位・単価・金額＋合計を返す（書き込まない）。内容を確認したら confirm:true で記録＝確定（管理画面の棚卸し履歴に載る）。単位は仕入れパック単位（袋/缶/本…）・自然単位（kg/L/個）・基準単位（g/ml）が使える（未指定は普段の仕入れ単位）。台帳に無い食材は自動作成しない（先に mf_ingredient(action='add')）。金額は実仕入れ値から自動算出。履歴の閲覧は mf_stocktake。

mf_add_stocktake

直近の実地棚卸しの結果（在庫金額・カウント済み品数）と履歴を返す（読み取り）。新しい棚卸しの記録は mf_add_stocktake。

mf_stocktake

あなた(AI)が書いた自己完結HTML(紙メニュー)を、MenuFreshのサーバーで印刷品質のPDFにして返す。サーバー側で料理写真(mf_menu の image URL=顧客サイト/Supabase)と日本語フォント(Noto Sans/Serif JP)を解決するので、**写真入り・フォント崩れなし**で出力できる(あなたの実行環境がCDNに繋げなくてOK)。html には CSS を内包した完全なHTML文書を渡す。用紙は html 内の @page{size:A4 …} を優先(landscape 引数でも指定可)。JSは実行されない(静的メニュー前提・安全のため)。戻り値 data.pdfUrl がPDFのダウンロードURL。まず mf_menu でデータと指針を取得してから使う。【重要】レンダリング前に、紙面の方向性（参考にしたい画像・雰囲気・フォント・版組・ページ枚数）をユーザーにまだ一度も確認していなければ、必ず先に一度確認すること。既定の構成で勝手に進めない（ユーザーが『お任せ』と言った場合のみ、あなたの判断で進めてよい）。

mf_render_paper_menu

食材(台帳)の登録・仕入れ値設定・更新・削除。action=add(新規追加・任意で仕入れ値も)/ set_price(既存に仕入れ値を設定)/ update(名前・分類等)/ delete(削除・confirm要)。name か ingredient_id で対象指定。読み取りは mf_list_ingredients。

mf_ingredient

店の食材一覧を、基準単位あたりの単価（実仕入れ値）・仕入れ先・価格設定の有無つきで返す（読み取り）。新メニューを実原価で考えるときの“素材パレット”。query（名前で絞り込み）・category・only_unpriced（仕入れ値未設定だけ）で絞れる。

mf_list_ingredients