FoodPerfect Docs

FoodPerfect for AI agents

FoodPerfect runs social media for restaurants: brand strategy, AI food photos and reels, scheduling and publishing to Instagram, Facebook, TikTok and LinkedIn. Everything your team does in the app, an AI agent can do through the FoodPerfect MCP server.

MCP (the Model Context Protocol) is the open standard that AI assistants use to call outside tools. Connect FoodPerfect once and your agent can read the brand, generate content, plan the calendar and publish, with your approval before anything goes live.

#What an agent can do

Area Tools Example ask
Account and brand get_account, get_brand_dna, update_brand_dna, run_brand_analysis, regenerate_brand_dna "What's my balance? Analyze my Instagram and build a brand strategy."
Photos, promos and menus generate_photo, generate_promo, generate_menu, photo_prompt, edit_image, remove_background, upscale_image, upload_asset "Make a promo, then brighten it and add a banner."
Video and reels list_reel_presets, create_reel, generate_reel_script, animate_reel_shot, generate_reel_music, render_reel, schedule_reel_post, generate_video_from_image, scrape_trending_hooks "Make a reel with animated shots and schedule it for Monday."
Planning and publishing generate_publish_schedule, generate_scheduled_post_content, list_scheduled_posts, publish_post_now "Plan the next two weeks and publish tomorrow's post."
Inbox and replies list_inbox, get_inbox_item, get_inbox_settings, draft_reply, send_reply, set_inbox_status, sync_inbox, update_inbox_settings, moderate_comment "Answer comments about our hours with an AI draft, then send it."
Library list_generations, get_generation, list_assets, delete_generation, delete_asset "Show me every promo from this month."
Accounts get_connect_link, finalize_connection "Give me a link to connect our TikTok."

#How it works

  1. You create an API key in the FoodPerfect app under Settings → API Keys. A key belongs to one FoodPerfect account and can be limited to certain tools.
  2. Your MCP client connects to https://mcp.foodperfect.ai/mcp over Streamable HTTP and sends the key as a bearer token.
  3. The agent calls tools. Reads are free. Generations draw from the account's dollar balance at the plan's rates, the same as in the app.
  4. Risky actions wait for approval. Publishing, scheduling a reel and deleting return a preview and an approval token first. Nothing goes live until the call is confirmed.

Note

The FoodPerfect MCP server is in early access, and tools and limits may still change. If something doesn't work, email support@foodperfect.ai with the x-request-id from the response.

#Good to know

  • One transport: Streamable HTTP at https://mcp.foodperfect.ai/mcp. There is no local (stdio) package to install. Clients that only speak stdio can use the mcp-remote bridge, see Connect a client.
  • Stateless: every request stands alone. There are no MCP sessions to keep alive.
  • Same account, same rules: an agent sees what the key's owner sees in the app and pays the same prices. It can't reach other accounts.
  • Built for agents to read: every page has a Markdown version (Copy page, top right), and /llms.txt indexes the docs for LLMs.