Skip to content
Platebreaker Logo Platebreaker Logo Platebreaker

MCP Integration

Integrate PlateBreaker nutrition data into your AI applications using our Model Context Protocol (MCP) server.

Overview

Section titled “Overview”

The PlateBreaker MCP server provides AI agents with access to personalized nutrition data, recipe information, and user meal tracking. Built for integration with Claude and other AI systems that support the MCP protocol.

What is MCP?

Section titled “What is MCP?”

Model Context Protocol is an open protocol developed by Anthropic that allows AI applications to securely connect to external data sources and tools. Think of it as a standardized way for AI assistants to access your services.

PlateBreaker MCP Capabilities

Section titled “PlateBreaker MCP Capabilities”

Our MCP server exposes the following capabilities to AI agents:

1. Personalized Nutrition Context

Section titled “1. Personalized Nutrition Context”
  • Access authenticated user’s nutritional targets
  • View current nutrient intake vs goals
  • Identify nutrient gaps for recommendations

2. Recipe Data Access

Section titled “2. Recipe Data Access”
  • Search recipes by nutritional criteria
  • Get detailed nutrition facts (~80 nutrients via USDA)
  • Find recipes that fill specific nutrient gaps

3. Meal Planning Integration

Section titled “3. Meal Planning Integration”
  • Add recipes to user’s meal plan
  • View planned meals
  • Generate shopping lists

4. Tracking Integration

Section titled “4. Tracking Integration”
  • Log meals to user’s nutrition tracker
  • View historical tracking data
  • Calculate nutritional progress

Use Cases

Section titled “Use Cases”

AI Nutrition Coach

Section titled “AI Nutrition Coach”

Build an AI assistant that:

  • Analyzes user’s nutrition gaps
  • Recommends specific recipes
  • Helps plan balanced meals
  • Tracks progress toward goals

Recipe Discovery Agent

Section titled “Recipe Discovery Agent”

Create agents that:

  • Find recipes matching specific nutrient needs
  • Compare recipes nutritionally
  • Suggest meal combinations
  • Account for dietary restrictions

Health App Integration

Section titled “Health App Integration”

Integrate into existing health apps:

  • Embed nutrition-aware recipe search
  • Show personalized recommendations
  • Track meals across platforms
  • Sync with user’s PlateBreaker account

Getting Started

Section titled “Getting Started”
  1. Install the MCP Server: Follow the OpenAI SDK Integration guide
  2. Configure Authentication: Set up OAuth for user authentication

Authentication & Security

Section titled “Authentication & Security”

OAuth 2.0 Flow

Section titled “OAuth 2.0 Flow”
  • Users authenticate with their PlateBreaker account
  • Your application receives access tokens
  • MCP server validates tokens on each request
  • Tokens expire and must be refreshed

Privacy & Permissions

Section titled “Privacy & Permissions”
  • Users control which data is accessible
  • Nutrition data is private by default
  • Users must explicitly grant access
  • Access can be revoked at any time

Architecture

Section titled “Architecture”
Your Application
      ↓
MCP Client (OpenAI SDK)
      ↓
PlateBreaker MCP Server
      ↓
PlateBreaker API
      ↓
User's Nutrition Data

Next Steps

Section titled “Next Steps”

Support

Section titled “Support”