# WhatCombines

> Food pairings for 677 ingredients: for any ingredient, the other ingredients that go with it, each ranked by strength from 1 (good) to 4 (made for each other). 12445 pairings in all.

Pairings are mutual: if basil pairs with tomatoes, tomatoes pair with basil. Strength scale: 1 = good, 2 = reliable, 3 = classic, 4 = made for each other. About 420 ingredients also carry flavour notes: season, taste, intensity, weight, techniques and a cooking tip.

## Read

- [Every ingredient, A to Z](https://whatcombines.com/foods.md): one Markdown link per ingredient
- Any ingredient as Markdown: https://whatcombines.com/with/{slug}.md, for example [basil](https://whatcombines.com/with/basil.md)
- What pairs with two ingredients at once: https://whatcombines.com/with/{slug}/{slug}.md, for example [basil and tomatoes](https://whatcombines.com/with/basil/tomatoes.md)

## API (JSON, no key needed)

- [Search](https://whatcombines.com/api/search?q=tomato): https://whatcombines.com/api/search?q={query}, matches English and Spanish names, singular or plural, and suggests close spellings
- [Ingredient index](https://whatcombines.com/api/foods): every name, slug and pairing count
- One ingredient: https://whatcombines.com/api/foods/{slug}, with its notes and every pairing with its strength
- [Shared pairings](https://whatcombines.com/api/pairings?with=basil,tomatoes): https://whatcombines.com/api/pairings?with={a},{b}[,{c}], names or slugs

## WebMCP (in the browser)

Pages register WebMCP tools for agents running in the browser (document.modelContext, or navigator.modelContext in Chrome's preview):

- get_pairings: { ingredient, min_strength?, limit? }, read-only
- get_shared_pairings: { ingredients: [2 or 3], limit? }, read-only
- get_ingredient: { ingredient }, read-only
- open_ingredient_page: { ingredient, with? }, navigates the tab
- Forms: search_ingredients (every page), pair_with_ingredient and filter_pairings (ingredient pages)

## Suggested use

To answer "what combines with X", search for X, then read https://whatcombines.com/with/{slug}.md and lead with the strongest tiers. To combine two ingredients, read the two-ingredient page, which ranks each shared partner by its weaker link.