Developer Integration

Connect Pantry Persona to any MCP-compatible client.

MCP Server URL

Transport: Streamable HTTP

JSON Configuration

Works with Claude Code and any client that reads MCP config files.

OAuth (ChatGPT, Claude, browser-based clients)

json

{
  "mcpServers": {
    "pantry-persona": {
      "type": "http",
      "url": "https://www.pantrypersona.com/api/mcp"
    }
  }
}

API Key (Cursor, Windsurf, Cline, headless agents)

json

{
  "mcpServers": {
    "pantry-persona": {
      "type": "http",
      "url": "https://www.pantrypersona.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ppna_YOUR_API_KEY"
      }
    }
  }
}

Generate an API key at Settings → API Keys

CLI Commands

Claude Code

Smithery (any client)

Authentication

Pantry Persona supports OAuth 2.0 and API key authentication.

OAuth 2.0

Browser-based clients (ChatGPT, Claude) handle this automatically. Endpoints for manual configuration:

Authorization: https://www.pantrypersona.com/api/oauth/authorize

Token: https://www.pantrypersona.com/api/oauth/token

Method: PKCE (S256)

API Key

For headless clients that don't support browser-based OAuth (OpenClaw, Cursor, Windsurf, Cline, custom agents):

1. Generate an API key at Settings → API Keys

2. Pass it as a Bearer token in your config headers:

code

"Authorization": "Bearer ppna_YOUR_API_KEY"

Available Tools

20 tools grouped by capability. Data tools return structured results for model reasoning; render tools display widgets; mutations write user data; actions combine reads, writes, or external calls.

Data (5)

Return structured data for model reasoning. No widget, no mutation.

get_user_context: Household profiles, scheduling rules, and saved planning workflows.
get_pantry: Return pantry contents as structured data for reasoning.
find_recipes: Search the user’s saved recipes with pantry- and diet-aware filters.
get_insights: Purchase patterns, restock predictions, and brand preferences.
get_next_steps: Suggested next actions based on current household state.

Render (5)

Display a widget via _meta.ui. No mutation.

show_pantry: Display the pantry as an interactive widget.
show_shopping: Display the shopping list as an interactive widget.
show_recipes: Display recipe cards as an interactive widget.
show_meal_plan: Display the weekly meal plan calendar as a widget.
show_profiles: Display household member profiles as a widget.

Mutation (7)

Create, update, or delete user data.

manage_pantry: Add, update, or remove pantry items.
manage_shopping: Add items, check off purchases, manage aisle order, and export to Instacart.
manage_meal_plan: Commit meals to the weekly calendar after the user has chosen them.
manage_recipes: Save recipes from URLs, pasted text, or edits; update ratings and notes.
manage_profiles: Create or update household member profiles and diets.
manage_collections: Organize recipes into named collections.
manage_preferences: Set household dietary rules and day-of-week scheduling.

Action (3)

Specific operations that combine reads, writes, or external calls.

shop_for_meal_plan: Generate a shopping list from a committed meal plan.
post_cook: Log a cook, increment history counters, and deduct pantry stock.
process_receipt: Parse a receipt image (model vision first) and add items to the pantry.