io.github.itsryanarmani/winecellarbuilders is an MCP server published by io.github.itsryanarmani, hosted at winecellarbuilders.fyi. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including search_listings, get_listing, list_places, list_categories, get_stats.
Find the team for your wine room.
121 connections through 5 shared values. Tap any node.
Search published wine cellar specialists by text, place and category.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search text, with at least one letter or digit. Matches name, categories, attributes, description and place. Typos fall back to close matches. |
| city | string | City slug, from /places. |
| sort | string | `relevance` needs `q` and is the default with it. `name` is the default without `q`. `recent` is newest first. |
| limit | integer | Items per page. |
| cursor | string | `page.nextCursor` from the previous response. Opaque. Send the same filters and `limit`. |
| region |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| string |
| Region slug, from /places. |
| country | string | ISO 3166-1 alpha-2 country code, any case. A country the directory does not cover, as listed in /places, gives 400. |
| category | string | Category slug, from /categories. A parent slug also matches its children. |
{
"name": "search_listings",
"title": "Search Listings",
"description": "Search published wine cellar specialists by text, place and category.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Search text, with at least one letter or digit. Matches name, categories, attributes, description and place. Typos fall back to close matches."
},
"city": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "City slug, from /places."
},
"sort": {
"enum": [
"relevance",
"name",
"recent"
],
"type": "string",
"description": "`relevance` needs `q` and is the default with it. `name` is the default without `q`. `recent` is newest first."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Items per page."
},
"cursor": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "`page.nextCursor` from the previous response. Opaque. Send the same filters and `limit`."
},
"region": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "Region slug, from /places."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, any case. A country the directory does not cover, as listed in /places, gives 400."
},
"category": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "Category slug, from /categories. A parent slug also matches its children."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one published wine cellar specialist by its slug.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | The listing slug. |
{
"name": "get_listing",
"title": "Get Listing",
"description": "Get one published wine cellar specialist by its slug.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "The listing slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List countries, regions and cities that have wine cellar specialists.
No parameters.
{
"name": "list_places",
"title": "List Places",
"description": "List countries, regions and cities that have wine cellar specialists.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List categories with their wine cellar specialist counts.
No parameters.
{
"name": "list_categories",
"title": "List Categories",
"description": "List categories with their wine cellar specialist counts.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the number of published wine cellar specialists, places and categories, and when the data last changed.
No parameters.
{
"name": "get_stats",
"title": "Get Stats",
"description": "Get the number of published wine cellar specialists, places and categories, and when the data last changed.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List where the wine cellar specialist data comes from, with the license and refresh of each source.
No parameters.
{
"name": "list_sources",
"title": "List Sources",
"description": "List where the wine cellar specialist data comes from, with the license and refresh of each source.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the affiliate products, with the price each had on the day it was checked. Filter by product category.
| Parameter | Type | Description |
|---|---|---|
| category | string | A product category slug. |
{
"name": "list_products",
"title": "List Products",
"description": "List the affiliate products, with the price each had on the day it was checked. Filter by product category.",
"inputSchema": {
"type": "object",
"properties": {
"category": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "A product category slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one affiliate product by its slug, with its page and outbound link.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | The product slug. |
{
"name": "get_product",
"title": "Get Product",
"description": "Get one affiliate product by its slug, with its page and outbound link.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "The product slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the product categories with their product counts.
No parameters.
{
"name": "list_product_categories",
"title": "List Product Categories",
"description": "List the product categories with their product counts.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the published academy courses with their level, length, pass mark and certificate validity.
| Parameter | Type | Description |
|---|---|---|
| level | string | Only courses of this level. |
| limit | integer | Most courses to return. |
{
"name": "list_courses",
"title": "List Courses",
"description": "List the published academy courses with their level, length, pass mark and certificate validity.",
"inputSchema": {
"type": "object",
"properties": {
"level": {
"enum": [
"foundations",
"practitioner",
"specialist"
],
"type": "string",
"description": "Only courses of this level."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 50,
"minimum": 1,
"description": "Most courses to return."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get one published academy course by its slug, with its objectives, lessons and FAQ. Exam questions and answers are never returned.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | The course slug. |
{
"name": "get_course",
"title": "Get Course",
"description": "Get one published academy course by its slug, with its objectives, lessons and FAQ. Exam questions and answers are never returned.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 100,
"minLength": 1,
"description": "The course slug."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}WineCellarBuilders lists wine cellar specialists. Privacy policy: https://winecellarbuilders.fyi/privacy. Call list_places and list_categories first to learn the place and category slugs. Then call search_listings, and get_listing for one record. Every result has meta.attribution and meta.sources. Show the credit line, and keep the license of each source. A wine cellar specialist is a record, not an endorsement. list_product_categories, list_products and get_product read the affiliate products. A price is the one seen on price_as_of, not a live price; buy_url is an affiliate link. list_courses and get_course read the published academy courses. Exam questions and answers are never returned. With a service token in the Authorization header, tools/list also offers the write tools that the token's scopes allow.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.