Developer

Flavonomics is a flavor reasoning engine that agents can call. It is a culinary intelligence layer used to build applications with a deep knowledge of how things taste to humans. Use the API surface for direct integrations, or connect the remote MCP server when your client needs Flavonomics as a live tool surface.

Why FlavonomicsFull docs on GitHub

Agentic systems become much more valuable when they can call a domain-specific, structured, trusted knowledge source instead of relying on the standard outputs of large language models. Flavonomics provides the most comprehensive and accurate data on flavour profiles and flavour relationships, making it a crucial tool for agentic systems that need to think about food and drink.

Semantic Pairing Graph

Pairings rank flavour harmony from learned flavour profiles, blended with how often ingredients share real recipes.

Explainability Included

Facet-level rationale with include_facets=true — shared and complementary notes.

Built for Product Workflows

Search, resolve, pair, and validate with stable v1 endpoints and predictable response envelopes.

API Or MCP

Both surfaces use the same flavour intelligence, but they are optimized for different integration styles. Choose the API when your application wants direct HTTP responses. Choose MCP when an agent client should discover and call Flavonomics tools during a conversation or workflow.

Stable request/response endpoints

HTTP API

Use the v1 API when you want explicit endpoint control, predictable envelopes, and direct application integration.

Auth: x-api-key

Tooling for agent clients

Remote MCP

Connect ChatGPT or another OAuth-capable client to the MCP server with any paid Flavonomics membership.

Auth: OAuth · Streamable HTTP /mcp

Two key types, two surfaces

Key Management

MCP keys are available with any paid membership for clients that use keys. HTTP API keys require Enterprise.

Auth: /developer + /account

HTTP API

Base URLs: https://www.flavonomics.com/api/v1/... or https://api.flavonomics.com/v1/.... Authenticate every request with an x-api-key header. HTTP API keys are available on the Enterprise plan. Responses use a consistent envelope with top-level data and meta fields.

Rate limits apply per account, shared by all of its keys: 120 requests per minute and 20,000 per day. Similarity lookups for unrecognised ingredient names are limited to 30 per hour. Over a limit, the API returns 429 with a Retry-After header giving the seconds to wait.

GET /api/v1/ingredients/search

Partial and fuzzy ingredient lookup with canonical matches and pagination.

GET /api/v1/ingredients/{ingredient}/similar

Semantic nearest-neighbour recommendations for a resolved ingredient.

GET /api/v1/ingredients/{ingredient}/pairings

Ranked pairings (flavour harmony blended with recipe co-occurrence) with optional facet-level explainability.

GET /api/v1/ingredients/{ingredient}/profile

Raw flavour profile access with top facets and optional full vector output.

GET /api/v1/pair

Compatibility checks for two or more ingredients in one call.

GET /api/v1/facets/{facet}/associations

Facet-to-facet association evidence for explainable flavour reasoning.

GET /api/v1/barlab/country-cocktails

Country-aware Bar Lab cocktail-menu intelligence, optionally filtered by ingredient.

GET /api/v1/barlab/ingredient-trio

Bar Lab synergy, shared flavour-note triads and example cocktails for exactly three ingredients.

Remote MCP

Remote MCP access is included with any paid Flavonomics membership. Connect ChatGPT to https://www.flavonomics.com/mcp using Streamable HTTP, then sign in through OAuth with the email address of your paid Flavonomics account. ChatGPT does not need an MCP key.

ChatGPT setup

Get access

Join the Flavour Society for ChatGPT. New members can create an account and complete payment there; free members can upgrade there.
Connect the MCP server in ChatGPT using the URL above and choose OAuth.
Sign in with the same email address as your paid Flavonomics account.

Other MCP clients

Use an MCP key

Create a key below or from your account and send it as Authorization: Bearer YOUR_MCP_KEY to the same /mcp URL.

Membership required.

Remote MCP access is included with any paid membership. Join on the ChatGPT membership page to subscribe and connect through OAuth.

Setup

Connection Details

Server name: flavonomics-mcp.
Server URL: https://www.flavonomics.com/mcp (Streamable HTTP).
Authentication: OAuth for ChatGPT and other supported clients; an MCP key for key-based clients.
Access: any paid Flavonomics membership, including Flavour Society.
Tool calls are limited per account: 30 per minute with an MCP key, 60 per minute with OAuth.

Surface

Available Tools

query_database

Run read-only SQL (SELECT, WITH, EXPLAIN) with a 5s timeout and a 500-row cap.

resolve_ingredients

Resolve free-text ingredients to canonical Flavonomics ingredient names.

get_ingredient_profiles

Fetch dominant flavour notes; pass detail: "full" for raw vectors and chart-ready scores.

get_flavour_profiles

Exact 0-10 scores for flavour groups, basic tastes, top notes, and any notes you name.

rank_by_flavour_dimension

Rank ingredients by one flavour note, group, or basic taste, highest or lowest first.

compare_flavour_profiles

Compare two or more profiles and show where they differ most.

find_similar_flavour_profiles

Find ingredients that taste most like one ingredient (similar taste, not pairing partners).

get_flavour_associations

Return dominant facets and their strongest associated flavour notes.

get_recommended_pairings

Get ranked pairings (the same ranking as the homepage and the HTTP API) for food, drinks, or both.

get_recipe_cooccurrence

Inspect recipe co-occurrence evidence and uplift metrics for a set of ingredients.

get_cuisine_ingredient_insights

Explore one ingredient within a cuisine: matching recipes, flavour profile, and pairings ranked by frequency, harmony, and overall score.

get_explanation_evidence

Assemble structured flavour evidence, including optional seasonal context.

get_country_cocktail_intelligence

Search country-scoped cocktail menus for popular ingredients, flavour triads, and examples.

get_bar_lab_intelligence

Bar Lab synergy, shared flavour-note triads, and example cocktails for one to three ingredients.

Live Demo

/ingredients/{ingredient}/profile — Top 5 flavour notes for an ingredient

Access Tiers

Start free, then move up when you need production integrations. Keys are managed on this page or from /account.

Plan

Price

Includes

Free Account

GBP 0 / USD 0

Basic flavour exploration, community support

Flavour Society

From GBP 14 / USD 19 per month

Unlimited in-app searches, advanced flavour tools, team workflows, remote MCP access

EnterpriseAPI Enabled

From GBP 1250 / USD 1672 per month

HTTP API and MCP access for integration, custom analytics, white-label options, priority support

View full membership options

HTTP API Keys

HTTP API keys require Enterprise. MCP access through OAuth is included with any paid membership.

Terms Summary

Flavonomics grants customers a limited, revocable licence to use its website, API and MCP services during their subscription term, but retains all ownership of the underlying service, data, flavour profiles, scoring methods and other intellectual property. Users must not copy, scrape, systematically extract, cache or store outputs in a way that reconstructs or replicates the database, build competing products from the service, reverse engineer the platform, share credentials, or bypass rate limits or other access controls. Use is subject to plan limits, fees, and any commercial restrictions on redistribution or embedding, and Flavonomics may monitor usage, impose caps, suspend access for misuse or security risks, and require deletion of retained outputs. Read the full Terms of Service.