# AgentSomm

> Wine intelligence API and MCP server backed by 200,000+ competition medals from 90+ international wine competitions. Real award data, not AI-generated tasting notes.

AgentSomm is the first wine-focused MCP server and REST API designed for AI agents. It provides structured wine recommendations, search, food pairings, and detailed wine profiles — all backed by verified competition medal data spanning 2015-2026.

## What AgentSomm Does

- Recommends wines by preference, budget, occasion, and food pairing
- Searches 62,000+ wines by name, varietal, region, price, and medal level
- Returns detailed wine profiles with full competition medal history
- Compares wines side-by-side with award data
- Suggests food pairings backed by sommelier knowledge and award patterns

## Why AgentSomm Exists

LLMs hallucinate wine information. They invent vintages, fabricate tasting notes, and recommend wines that don't exist. AgentSomm solves this by providing a structured database of real wines with verified competition results. Every recommendation is traceable to a specific medal at a specific competition.

## Data Sources

- San Francisco Chronicle Wine Competition (61,000+ wines, 2015-2026)
- Global Wine Medal Report — 90+ international competitions (200,000+ wines)
- 3,700+ verified producers

## Docs

- [API Documentation](https://agentsomm.com/docs)
- [MCP Server Installation](https://agentsomm.com/docs/mcp)
- [GitHub Repository](https://github.com/ogdeeeezy/agentsomm)

## API Endpoints

- GET /api/recommend — Wine recommendations by preference, budget, occasion, food
- GET /api/search — Search wines by name, varietal, region, price, medal level
- GET /api/wine/{id} — Full wine details with medal history
- GET /api/wine?name= — Look up wine by name with optional producer and vintage
- GET /api/compare?wines= — Side-by-side wine comparison
- GET /api/food-pairing?dish= — Wine recommendations for a specific dish
- GET /api/stats — Database statistics

## MCP Tools

- recommend_wine — Recommend wines by preferences, budget, occasion, food pairing
- search_wines — Search by name, varietal, region, price, medal level
- wine_details — Detailed info on a specific wine
- compare_wines — Compare two or more wines
- food_pairing — Get wine recommendations for a dish

## Pricing

- Free: 500 API calls/month
- Pro ($29/mo): 10,000 calls/month
- Scale ($99/mo): 100,000 calls/month

## Contact

- GitHub: https://github.com/ogdeeeezy/agentsomm
- Website: https://agentsomm.com