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.
Supports GET (discovery/status) and POST (JSON-RPC 2.0 Streamable HTTP) with full CORS support.
Supports static Bearer API keys and OAuth 2.1 authorization with /.well-known/oauth-protected-resource discovery.
All 4 exposed MCP tools are strictly read-only (readOnlyHint: true, destructiveHint: false). Database mutations are disabled over MCP.
Add this to mcp_config.json in your Antigravity plugin or MCP client configuration:
{
"mcpServers": {
"foodrepo": {
"serverUrl": "https://food.seyone.dev/api/mcp"
}
}
}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":{}}'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.
Pass the resolved UUID to get_ingredient_details to retrieve USDA nutrition facts, flavor pairings, botanical varieties, and culinary derivatives.
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 IngredientsSearch canonical culinary ingredients across names, multilingual aliases, country of origin, regional sub-cuisines, and organoleptic flavor profiles.
| Parameter | Type | Description |
|---|---|---|
| query | string | Keyword for ingredient name or alias (e.g. 'cinnamon', 'goraka') |
| cuisine | string | Culinary tradition filter (e.g. 'Sri Lankan', 'Indian', 'Italian') |
| country | string | Country of origin filter (e.g. 'Sri Lanka', 'India') |
| region | string | Regional hierarchy filter (e.g. 'South Asia', 'Mediterranean') |
| flavor | string | Organoleptic flavor attribute (e.g. 'Sour', 'Aromatic', 'Umami') |
| page | integer | 1-indexed pagination page (default: 1) |
| limit | integer | Records per page, max 50 (default: 15) |
| includeProducts | boolean | Attach mapped retail products and barcodes (default: false) |
{
"query": "goraka",
"cuisine": "Sri Lankan",
"limit": 5
}get_ingredient_detailsGet Ingredient DetailsRetrieve the full canonical specification for an ingredient by UUID, including USDA nutritional facts, flavor pairings, botanical varieties, and culinary derivatives.
| Parameter | Type | Description |
|---|---|---|
| id* | string | Unique UUID of the canonical ingredient |
| includeProducts | boolean | Attach mapped supermarket retail products (default: true) |
{
"id": "00000000-0000-0000-0000-000000000000",
"includeProducts": true
}get_ingredient_pricesGet Ingredient PricesFetch live retail pricing, stock status, pack sizes, and store availability across Sri Lankan supermarket chains (Keells, Cargills Online, Glomark).
| Parameter | Type | Description |
|---|---|---|
| id* | string | Unique UUID of the canonical ingredient |
{
"id": "00000000-0000-0000-0000-000000000000"
}match_ingredientMatch Ingredient SemanticsPerforms semantic embedding vector matching to resolve raw recipe text or supermarket product descriptions to the closest canonical ingredient.
| Parameter | Type | Description |
|---|---|---|
| query* | string | Raw food name or product phrase (e.g. 'Ceylon Cinnamon sticks 50g') |
{
"query": "Ceylon Cinnamon sticks 50g"
}