Pairing intelligence for your product, in one call

Send a dish in any of eight languages and get ranked wines with a score and a reason. Restrict results to your own range, enrich recipes and menus, or let your AI agent call Gastrona directly.

Start freeTalk to us

Free test mode on real data. No card needed.

{
  "object": "recommendation_set",
  "resolution": { "input_kind": "text", "confidence": 0.9 },
  "data": [
    { "wine": { "name": "Viña Ardanza Reserva 2016" },
      "score": 93, "band": "exceptional",
      "explanation": { "summary": "Mature Rioja brings savoury depth for lamb and rosemary." } },
    { "wine": { "name": "Bourgogne Pinot Noir 2022" },
      "score": 90, "band": "exceptional",
      "explanation": { "summary": "Silky tannins and red fruit keep the garlic and herbs fresh." } },
    { "wine": { "name": "Kanonkop Paul Sauer 2019" },
      "score": 87, "band": "exceptional",
      "explanation": { "summary": "Firm structure for pink-roasted lamb and its jus." } }
  ],
  "language": "en", "engine_version": "2026-11"
}

Everything food and wine, one API

Pairing in both directions, scores, sides and whole menus. Wine and dish search, recipes, cocktails, menu and wine-list extraction, translation, images and a hosted sommelier.

  • Wines for a dish and dishes for a wine
  • Batch scoring for whole menus and catalogs
  • Asynchronous jobs with webhooks for imports and generation
recommendations.winesrecommendations.dishesrecommendations.menuscores.batchwines.searchdishes.analyzecatalogs.importsrecipes.from_urlcocktailssommelier.threadsvision.labelsmenus.extractwine_liststranslationsimagesrestaurantsinsightsembed_sessionsmcp

From key to first pairing in five minutes

Create a test key, copy the example and see your request, response, credits and timing in the request explorer. TypeScript and Python SDKs are generated from the same contract.

  • Interactive reference with try-it
  • Request log and usage per application
  • Secret, restricted and publishable keys
Gastrona developer console with a five-minute quickstart, test usage and credits per call

Your agent speaks Gastrona

The API is also a Model Context Protocol server. Point Claude, ChatGPT or your own agent at it and every public operation becomes a tool, with the same keys, limits and request log.

  • One tool per public operation
  • Scopes limit what an agent can do
  • Same credits and idempotency as direct calls
mcp.json
{
  "mcpServers": {
    "gastrona": {
      "type": "http",
      "url": "https://api.gastrona.io/v1/mcp",
      "headers": { "Authorization": "Bearer gk_test_…" }
    }
  }
}

Everything you expect from a modern API

Your catalog, our intelligence
Upload your products by SKU or CSV and get recommendations only from what you sell, with your prices and links.
Scores you can explain
0 to 100 with fixed bands. Recommendations include only good matches, each with a summary in the requested language.
Test mode on real data
The real engine and catalog with a free daily allowance. Same code, same responses when you go live.
Safe retries
Idempotency keys on every write. Retries replay the original response and are never charged twice.
Webhooks and jobs
Standard Webhooks for imports and generation, with a catch-up event feed.
Browser-ready
Publishable keys and short-lived embed sessions, so secrets never reach the browser.

Questions, answered

Yes. Test keys use the real engine and data with a free daily allowance and are never billed. When you go live, usage is metered with spending limits you control. Talk to us about volume.

Yes. Create a catalog with your products by SKU or CSV upload, review how each product matched our catalog and pass the catalog in your request. Results include your SKU, price and product URL.

Requests take a language (English, Swedish, German, French, Spanish, Italian, Portuguese or Dutch) and a market. Explanations are written in the requested language; availability and prices follow the market.

Yes. Connect any Model Context Protocol client to api.gastrona.io/v1/mcp with an API key. Each public operation is a tool, metered exactly like a direct call.

Works withBranded AppsGastrona ProAI

Built forWine retail & e-commerceRecipe sites & mediaPlatforms & developers

Get your first pairing in five minutes

Create a free test key, send a dish and see ranked wines with reasons. Same code when you go live.

Start freeTalk to us

No card needed. Set up a venue or get an API key in minutes.

  1. 1Get a test keySign up and create a key that works on real data, free.
  2. 2Send your first dishCopy the example and see ranked wines with a score and a reason.
  3. 3Go live when you are readyThe same code in production, with spending limits you set.