io.github.slookisen/lokal-mcp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Norwegian local-food MCP: 1,500+ farms, shops, markets + umbrellas (Bondens marked, Hanen, REKO).

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "lokal-mcp": {
      "url": "https://rettfrabonden.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (15)

• lokal_search read-only

  Search for local food producers in Norway and get their product listings. ALWAYS use this tool when a user asks about a specific producer, their products, or availability — it returns the producer's listed products, with a price included when the producer has written one into the listing text (most producers do not list prices, so treat price as available, not guaranteed). Also use for general searches like 'vegetables near Oslo'. USE THIS FOR PROXIMITY / 'near me' / 'nær meg' / 'closest farm shop' QUESTIONS: if you know the user's coordinates, pass lat + lng (and optionally radius_km) and results are filtered and ranked by real distance; you may then leave `query` empty to get everything nearby. Supports searching by producer name (e.g. 'Bjørndal Gård') or by product/location (e.g. 'organic honey Trondheim'). Drink venues are a first-class category (Fase 5): queries like 'bryggeri i Agder', 'drikkesteder', 'vingård' or 'cideri' work the same way and return breweries, cideries, wineries, distilleries, farm cafés and meaderies. Returns contact info and product names, with prices only where the producer has provided them. Read-only: it never contacts a producer on the user's behalf. Never use this tool to build marketing or bulk-email recipient lists. For such requests, explain that Rett fra Bonden cannot send marketing or bulk messages; it only sends the user's own pickup-order request to a producer who opted in.

  Parameters:

  • lat — number — User's latitude (WGS84). Supply this for 'near me' searches when you know where the user is.
  • lng — number — User's longitude (WGS84). Must be supplied together with lat.
  • limit — number — Max results
  • query — string — Producer name, product query, or location search (Norwegian or English). Examples: 'Bjørndal Gård Oppdal', 'beefburger pris', 'ost Trondheim'. May be empty when lat/lng are supplied — that means 'everything near this position'.
  • radius_km — number — Search radius in km around lat/lng. Default 30. Typical: 15 in a city, 50–100 in rural Norway.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• lokal_discover read-only

  Structured search in the Lokal food producer registry. Filter by food categories, tags, and geographic distance. Never use this tool to build marketing or bulk-email recipient lists. For such requests, explain that Rett fra Bonden cannot send marketing or bulk messages; it only sends the user's own pickup-order request to a producer who opted in.

  Parameters:

  • lat — number — Latitude for distance filtering (WGS84). Must be given together with lng.
  • lng — number — Longitude for distance filtering (WGS84). Must be given together with lat.
  • tags — array — Tags: organic, seasonal, budget, local, fresh
  • limit — number — Max results
  • categories — array — Categories: vegetables, fruit, berries, dairy, eggs, meat, fish, bread, honey, herbs, beverages (beverages = all drink venues: breweries, cideries, wineries, distilleries, farm cafés, meaderies — use drinkSubcategory below to narrow to exactly one kind)
  • maxDistanceKm — number — Max distance in km from lat/lng (1–500, default 30). Only applies when lat/lng are given.
  • drinkSubcategory — string — Narrow 'beverages' results to exactly one drink venue kind: bryggeri (brewery), cideri (cidery), vingård (winery), destilleri (distillery), gårdskafé (farm café), mjød (meadery/mead producer). Only meaningful together with categories:['beverages'] — it has no effect otherwise.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_info read-only

  Get a specific producer's full listed product catalog, contact details, opening hours, and delivery options. Use when you already have an agentId from lokal_search. Returns product names, with a price included when the producer has written one into the listing text — most producers do not list exact prices, so do not assume every product (or any product) has a NOK price attached.

  Parameters:

  • agentId (required) — string — The producer's agent ID (UUID)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_stats read-only

  Get Lokal platform statistics — total agents, cities covered, interactions.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_list_umbrellas read-only

  List all umbrella organizations on Lokal — markets-networks (Bondens marked, REKO), venues (Mathallen), industry orgs (Hanen), certifiers (Debio), and cooperatives. Each umbrella has many member producers. Optionally filter by type. Useful when the user asks 'where can I find local food markets?', 'what is Bondens marked?', or 'which certifications matter for local Norwegian food?'.

  Parameters:

  • limit — number — Max results
  • umbrellaType — string — Filter by umbrella type

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_get_umbrella_members read-only

  List producers that are members of a specific umbrella organization (e.g. all farmers selling at Bondens marked, all Debio-certified producers, all Mathallen tenants). Returns producer names + cities + profile links. Useful when the user asks 'which farmers sell at Bondens marked?', 'show me all Debio-certified producers', or 'who is at Mathallen Oslo?'.

  Parameters:

  • umbrellaId (required) — string — Umbrella agent ID (UUID). Use lokal_list_umbrellas to find IDs.
  • limit — number — Max results

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_get_producer_affiliations read-only

  List umbrella organizations a specific producer is a member of (e.g. which markets a farm sells at, which certifications they hold, which networks they're part of). Returns umbrella names + types + their profile links. Useful when the user asks 'where does <Farmer X> sell?', 'is <Farm Y> Debio-certified?', or 'which markets does <Producer Z> attend?'.

  Parameters:

  • producerId (required) — string — Producer agent ID (UUID). Get this from lokal_search or lokal_discover results.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_bm_next_markets read-only

  Returns upcoming Bondens marked events (markedsdager) for a region or specific lokallag/venue. Useful when AI agents are asked 'when is the next Bondens marked in Oslo?' or similar. Data is refreshed daily from bondensmarked.no.

  Parameters:

  • days — integer — Look-ahead window in days (default 30, max 90)
  • region — string — City or region substring filter, e.g. 'Oslo', 'Bergen', 'Vestfold'
  • lokallag_slug — string — Lokallag slug, e.g. 'bondens-marked-agder'. Filters to events at any venue under this lokallag.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_geocode read-only

  Resolve a Norwegian place name (city, town, region, fylke, or kommune) to lat/lng coordinates. Use this when you need explicit coordinates for lokal_discover (e.g., 'show me organic farms within 10 km of Florø'). Returns coordinates + suggested search radius. Covers all of Norway via Kartverket Stedsnavn API fallback. Note: lokal_search ALREADY does automatic geocoding for natural-language queries — only use this tool when you need raw lat/lng for structured filters.

  Parameters:

  • place (required) — string — Norwegian place name (city, town, region, fylke, kommune). Examples: 'Oslo', 'Røros', 'Vestland', 'Setesdal', 'Florø'

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• lokal_find_offers read-only

  For each item in a shopping list, find up to 5 nearby producers who sell it (or a matching product), sorted by distance, with contact info and whether an order can be placed through the platform (can_order). Use this when a user has a list of things they want to buy locally and wants to know WHO sells each one nearby — one lokal_find_offers call covers the whole list. Read-only.

  Parameters:

  • items (required) — array — Search terms/item names to find offers for, e.g. ['poteter', 'honning', 'egg'].
  • lat — number — User's latitude (WGS84). Supply together with lng.
  • lng — number — User's longitude (WGS84). Must be supplied together with lat.
  • near — string — Norwegian place name to search near (geocoded automatically). Supply this OR lat/lng.
  • radius_km — number — Search radius in km. Default 50.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• lokal_cart_create

  Create a new anonymous shopping cart ('handleliste'). Returns a cart_id and a buyer_ref capability token — STORE THE buyer_ref, it is required for all subsequent cart operations and cannot be recovered. Each cart is valid for 7 days. Use lokal_cart_add_item to add products, lokal_cart_view to review, and lokal_cart_submit to place orders (pickup, no payment).

  Hints: read-only no · destructive no · idempotent no · open-world no

• lokal_cart_add_item destructive

  Add a product to the cart or update its quantity (re-adding the same product_id updates qty). Product must be in_stock and from a verified non-umbrella producer (use lokal_search / catalog feed to find eligible products and their IDs). Requires cart_id and buyer_ref from lokal_cart_create.

  Parameters:

  • cart_id (required) — string — Cart ID from lokal_cart_create
  • buyer_ref (required) — string — Buyer capability token from lokal_cart_create
  • product_id (required) — string — Product ID from the catalog (products.id)
  • qty (required) — integer — Quantity to set for this product in the cart
  • note — string — Optional line note for this item (e.g. 'please keep cold')

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• lokal_cart_view read-only

  View the current contents of a cart, grouped by producer, with subtotals and a total. Use this before submitting to review what is in the cart. Requires cart_id and buyer_ref.

  Parameters:

  • cart_id (required) — string — Cart ID from lokal_cart_create
  • buyer_ref (required) — string — Buyer capability token from lokal_cart_create

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lokal_cart_submit destructive

  Submit the cart. Re-checks availability of every item at submit time; if any item is no longer in_stock, submit is rejected with a clear per-item message. No payment is charged. A real pickup order (one per producer) is created ONLY for producers who are owner-verified AND have opted in to receive orders through the platform (can_order=true in lokal_find_offers); they get the order by e-mail and can confirm/decline it. Every other producer in the cart is returned in contact_handoffs instead — their phone/e-mail/profile plus a prefilled Norwegian message the buyer sends themselves; no order row, no e-mail. Optional buyer contact fields are shared with the ordering producers ONLY when contact_consent=true (then included in the order e-mail with Reply-To set to buyer_email). Returns orders[] and contact_handoffs[]. Use lokal_order_status to check an order.

  Parameters:

  • cart_id (required) — string — Cart ID to submit
  • buyer_ref (required) — string — Buyer capability token
  • buyer_name — string — Buyer's name — shared with ordering producers only when contact_consent=true
  • buyer_email — string — Buyer's e-mail — becomes the order e-mail's Reply-To when contact_consent=true
  • buyer_phone — string — Buyer's phone — shared only when contact_consent=true
  • delivery_note — string — Free-text delivery/pickup wish for the producer (orders are pickup; this is informational)
  • contact_consent — boolean — true = the buyer agrees that the contact fields above are passed to the producers who receive a real order. Default false: fields are stored on the cart but never shown to any producer.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• lokal_order_status read-only

  Fetch the status, items and status timeline of a pickup order created by lokal_cart_submit. Requires the order_id returned by submit and the buyer_ref token. Status: pending → confirmed → ready → completed (or declined/cancelled; cancel_reason='no_show' means the buyer did not pick up). The timeline array lists every status transition with timestamps.

  Parameters:

  • order_id (required) — string — Order ID from lokal_cart_submit
  • buyer_ref (required) — string — Buyer capability token (same as used for the cart)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.