Skip to main content
Glama
henrikogaard

Polvenn MCP Server

by henrikogaard
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
POLVENN_DATA_DIRNoOverride the data directory path. Default is ~/.polvenn

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
polvenn_search_new_beersA

Search for recently released beers on Vinmonopolet via the official API and/or your external release feed.

Args:

  • source ('vinmonopolet' | 'external' | 'both'): Where to search (default: 'both')

  • since (string, optional): Best-effort date filter yyyy-MM-dd using external release dates, otherwise Vinmonopolet lastChanged

  • includeUpcoming (boolean): Also include beers from Vinmonopolet's "Kommende nyheter" web filter

  • style (string, optional): Filter by beer style, e.g. 'IPA', 'Stout'

  • releaseDate (string, optional): Exact release date filter

  • storeId (string, optional): Limit Vinmonopolet-backed results to beers available in one store

  • limit (number): Max results (default: 25)

Returns: List of new beers with name, producer, style, ABV, article number, and release date.

polvenn_search_upcoming_beersA

Search Vinmonopolet's "Kommende nyheter" web listing for upcoming beer releases.

Args:

  • style (string, optional): Filter by beer style, e.g. 'IPA', 'Stout'

  • limit (number): Max results (default: 25)

Returns: List of upcoming beers with name, producer, style, ABV, article number, and current website status.

polvenn_search_new_beers_near_storeA

Search Vinmonopolet's current "Nyheter" listing for beers available in one store.

Args:

  • storeId (string, optional): Store ID. Falls back to your configured home store, then your nearest store from your home coordinates

  • style (string, optional): Filter by beer style, e.g. 'IPA', 'Stout'

  • releaseDate (string, optional): Exact release date filter

  • limit (number): Max results (default: 25)

Returns: New beers currently available in the selected store, enriched with external release dates when recent feed items match.

polvenn_check_store_stockA

Check if a specific beer is in stock at a Vinmonopolet store.

Args:

  • articleNumber (string): Vinmonopolet article number

  • storeId (string, optional): Store ID. Defaults to your configured home store.

Returns: Stock status and product details.

polvenn_find_nearby_storesA

Find the closest Vinmonopolet stores to a given location.

Args:

  • latitude (number, optional): Defaults to configured home location

  • longitude (number, optional): Defaults to configured home location

  • maxResults (number): How many stores to return (default: 5)

Returns: List of nearby stores with address, distance, category, and opening hours.

polvenn_watchlistA

Manage your beer watchlist. Track breweries, styles, series, or keywords to get notified about matching releases.

Args:

  • action ('add' | 'remove' | 'list' | 'check'): What to do

  • type ('brewery' | 'style' | 'series' | 'keyword'): Rule type (required for 'add')

  • value (string): What to watch for (required for 'add')

  • id (number): Entry ID to remove (required for 'remove')

polvenn_configureA

Set the release feed URL, API key, home store, and location for the Polvenn MCP server.

Args (all optional — only provided values are updated):

  • releaseFeedUrl: Base URL for your external release feed API

  • vinmonopoletApiKey: Subscription key from api.vinmonopolet.no

  • homeStoreId: Your preferred Vinmonopolet store ID

  • homeLatitude: Home latitude for nearby lookups

  • homeLongitude: Home longitude for nearby lookups

Returns: Current configuration (keys are masked).

polvenn_validate_configA

Validate current Polvenn configuration and run lightweight capability checks against upstream services.

Checks:

  • local config presence

  • external release feed access

  • Vinmonopolet product and store access

  • Vinmonopolet stock endpoint accessibility

Returns: A capability report with pass/warn/fail statuses.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored across 8 tools

Disambiguation4/5

Most tools are distinct, but the three search tools (search_upcoming_beers, search_new_beers, search_new_beers_near_store) have overlapping functionality, especially since search_new_beers can include upcoming results. Descriptions clarify differences, but there's a risk of selecting the wrong one.

Naming Consistency4/5

Tool names follow a consistent pattern with the 'polvenn_' prefix and verb_noun format (e.g., check_store_stock, search_new_beers). The exception is 'polvenn_watchlist' which uses a noun instead of a verb action, but it's still clearly named.

Tool Count5/5

With 8 tools, the server is well-scoped for its purpose: searching new/upcoming beers, checking stock, finding stores, managing a watchlist, and configuration. Each tool serves a distinct need without being excessive.

Completeness4/5

The domain of beer release tracking and store stock is well covered, including search, stock, store location, watchlist, and config. However, there's no general search for all beers, only new/upcoming, which may be a gap for users wanting to look up existing products.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources