Model Context Protocol (MCP)Streamable HTTPOAuth 2.1 + Bearer

FoodRepo MCP Server & Plugin Documentation

Connect AI agents (Antigravity, Claude, Cursor, and custom MCP clients) to 20,000+ canonical ingredients, botanical taxonomy, USDA nutrition profiles, semantic recipe matching, and live Sri Lankan supermarket pricing.

Remote MCP Endpoint
https://food.seyone.dev/api/mcp

Supports GET (discovery/status) and POST (JSON-RPC 2.0 Streamable HTTP) with full CORS support.

Authentication & OAuth 2.1

Supports static Bearer API keys and OAuth 2.1 authorization with /.well-known/oauth-protected-resource discovery.

read:ingredientsread:productsread:recipes
Strictly Read-Only MCP

All 4 exposed MCP tools are strictly read-only (readOnlyHint: true, destructiveHint: false). Database mutations are disabled over MCP.

Antigravity / MCP Client Config

Add this to mcp_config.json in your Antigravity plugin or MCP client configuration:

{
  "mcpServers": {
    "foodrepo": {
      "serverUrl": "https://food.seyone.dev/api/mcp"
    }
  }
}
Quick Verification (cURL)

Verify server health or inspect the JSON-RPC tools/list manifest directly:

# 1. Check server status & transport
curl -s https://food.seyone.dev/api/mcp

# 2. List available MCP tools (requires Bearer token or OAuth 2.1)
curl -s -X POST https://food.seyone.dev/api/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Recommended Agent Workflow
1. Resolve or Browse

Use match_ingredient for messy recipe lines (e.g. “Ceylon Cinnamon sticks 50g”) or search_ingredients for faceted filtering by cuisine, country, region, or flavor.

2. Inspect Nutrition & Taxonomy

Pass the resolved UUID to get_ingredient_details to retrieve USDA nutrition facts, flavor pairings, botanical varieties, and culinary derivatives.

3. Benchmark Retail Prices

Call get_ingredient_prices with the ingredient UUID to compare live pack sizes, stock, and prices across Keells, Cargills Online, and Glomark.

Exposed MCP Tools (4)

search_ingredientsSearch Ingredients
Read-onlyread:ingredients

Search canonical culinary ingredients across names, multilingual aliases, country of origin, regional sub-cuisines, and organoleptic flavor profiles.

ParameterTypeDescription
querystringKeyword for ingredient name or alias (e.g. 'cinnamon', 'goraka')
cuisinestringCulinary tradition filter (e.g. 'Sri Lankan', 'Indian', 'Italian')
countrystringCountry of origin filter (e.g. 'Sri Lanka', 'India')
regionstringRegional hierarchy filter (e.g. 'South Asia', 'Mediterranean')
flavorstringOrganoleptic flavor attribute (e.g. 'Sour', 'Aromatic', 'Umami')
pageinteger1-indexed pagination page (default: 1)
limitintegerRecords per page, max 50 (default: 15)
includeProductsbooleanAttach mapped retail products and barcodes (default: false)
Example Arguments
{
  "query": "goraka",
  "cuisine": "Sri Lankan",
  "limit": 5
}
get_ingredient_detailsGet Ingredient Details
Read-onlyread:ingredients

Retrieve the full canonical specification for an ingredient by UUID, including USDA nutritional facts, flavor pairings, botanical varieties, and culinary derivatives.

ParameterTypeDescription
id*stringUnique UUID of the canonical ingredient
includeProductsbooleanAttach mapped supermarket retail products (default: true)
Example Arguments
{
  "id": "00000000-0000-0000-0000-000000000000",
  "includeProducts": true
}
get_ingredient_pricesGet Ingredient Prices
Read-onlyread:products

Fetch live retail pricing, stock status, pack sizes, and store availability across Sri Lankan supermarket chains (Keells, Cargills Online, Glomark).

ParameterTypeDescription
id*stringUnique UUID of the canonical ingredient
Example Arguments
{
  "id": "00000000-0000-0000-0000-000000000000"
}
match_ingredientMatch Ingredient Semantics
Read-onlyread:ingredients

Performs semantic embedding vector matching to resolve raw recipe text or supermarket product descriptions to the closest canonical ingredient.

ParameterTypeDescription
query*stringRaw food name or product phrase (e.g. 'Ceylon Cinnamon sticks 50g')
Example Arguments
{
  "query": "Ceylon Cinnamon sticks 50g"
}