Skip to main content
Glama
markusl

Alko MCP Server

by markusl
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoThe port number for HTTP transport mode3000
MCP_TRANSPORTNoThe MCP transport type (http or stdio)stdio
FIRESTORE_EMULATOR_HOSTNoThe Firestore emulator host and port for local developmentlocalhost:8081

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_productsA

Search Finnish Alko alcohol catalog (~12,000 products). Filter by name, type, country, price, alcohol%. Returns: id, name, price, type, country, alcohol%, producer.

get_productA

Retrieve detailed product info by Alko product ID. Optional: includeEnrichedData=true adds taste profile, food pairings, serving tips (slower, scrapes alko.fi).

get_availabilityA

Check real-time product availability at Alko stores. Returns store names with stock quantities. Filter by city. Scrapes alko.fi for live data.

list_storesA

List all ~360 Alko stores in Finland. Filter by city name. Returns: store id, name, address, city, postal code.

get_store_hoursA

Get Alko store opening hours for today and tomorrow. Filter by store name, city, or openNow=true for currently open stores. Auto-refreshes stale data.

get_recommendationsA

Get personalized product recommendations. Specify occasion, food pairing (uses Alko official pairing data), price range, or preferences (organic, vegan). Supports 33 food categories.

get_vivino_ratingA

Look up wine ratings from Vivino.com. Search by wine name/winery or provide direct URL. Returns: average rating (1-5 stars), rating count, wine details. Results are cached.

sync_productsA

Admin: Download latest Alko price list and update product database. Takes 2-5 minutes. Updates ~12,000 products. Use get_sync_status to check progress.

get_sync_statusA

Check database health: product count, last sync timestamp, sync status. Use to verify data freshness before searches.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/markusl/alko-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server