lokal
Search and discover Norwegian local food producers, retrieve producer details/stats, and access resources via MCP/HTTP/A2A.
Natural-language producer search (
lokal_search) in NO/EN with ranked contacts, vCard links, and auto-started conversations with top matches.Structured discovery (
lokal_discover) by categories, tags, coordinates, radius, and auto-started conversations.Full producer info (
lokal_info): address, products, opening hours, certifications, vCard.Platform stats (
lokal_stats): total agents, cities, interactions.MCP resources: aggregate producer overview by city and specific producer JSON.
Connect via remote MCP, local stdio, REST API, or A2A JSON-RPC.
Built with Express.js framework, providing RESTful API endpoints for marketplace search, discovery, producer details, and platform statistics.
Deployed on Fly.io cloud platform in Stockholm region, providing scalable infrastructure for the local food discovery service.
Uses SQLite database with WAL mode and persistent volume for storing and querying data on 400+ food producers across 150+ Norwegian cities.
Built with TypeScript, providing type-safe API endpoints and structured data handling for the local food discovery platform.
Provides OpenAPI 3.1 specification in YAML format for API documentation and integration with tools like ChatGPT Custom GPTs.
🥬 Rett fra Bonden — Local Food Agent Network for Norway
Live: https://rettfrabonden.com | MCP Server: https://rettfrabonden.com/mcp | API Spec: https://rettfrabonden.com/openapi.yaml
Rett fra Bonden is the discovery layer for local food in Norway. 1,500+ producers — farms, farm shops, REKO rings, farmers markets, and cooperatives — discoverable by AI agents and humans alike.
Not an app. Not a webshop. Infrastructure — the DNS for food agents.
Use Rett fra Bonden
From Claude (remote MCP via Claude Connectors)
The recommended setup for Claude.ai users: connect the remote MCP server directly, no local install required.
MCP Server URL:
https://rettfrabonden.com/mcpTransport: Streamable HTTP (MCP protocol 2025-06-18)
Authentication: None required — the server is publicly accessible
Once connected, ask Claude things like:
"Finn økologiske grønnsaker nær Oslo som leverer hjem"
"Which dairy farms in Rogaland sell raw milk directly to consumers?"
"Compare three honey producers in Innlandet — who ships nationwide?"
From Claude Desktop (MCP stdio)
If you prefer a local install over remote:
{
"mcpServers": {
"lokal": {
"command": "npx",
"args": ["lokal-mcp"]
}
}
}From ChatGPT (Developer Mode / Custom GPT)
Developer Mode: Add https://rettfrabonden.com/mcp as the MCP server URL.
Custom GPT: Create a GPT with Actions pointing to https://rettfrabonden.com/openapi.yaml. Instructions in custom-gpt-instructions.md.
From your own agent (A2A / REST)
# Natural language search
curl "https://rettfrabonden.com/api/marketplace/search?q=organic+vegetables+near+Oslo"
# Structured discovery
curl -X POST https://rettfrabonden.com/api/marketplace/discover \
-H "Content-Type: application/json" \
-d '{"categories":["vegetables"],"tags":["organic"],"lat":59.91,"lng":10.75,"maxDistanceKm":30}'
# A2A JSON-RPC
curl -X POST https://rettfrabonden.com/a2a \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"message/send","params":{"message":{"role":"user","parts":[{"type":"text","text":"Find cheese near Bergen"}]}},"id":"1"}'Related MCP server: datakilder-mcp
MCP Tools & Resources
The remote MCP endpoint at /mcp exposes four tools and two resources.
Tool | Purpose | Read/Write |
| Natural-language producer search (NO/EN). Auto-starts a conversation with top matches so sellers can respond. | Read + Write |
| Structured filter — categories, tags, geo-radius. Auto-starts conversations. | Read + Write |
| Full producer profile — address, products, opening hours, certifications. | Read only |
| Platform-level metrics — total agents, cities covered. | Read only |
Resource URI | Mime | Description |
|
| Aggregate view of producers by city |
|
| Detailed info about a specific producer |
HTTP API
Endpoint | Method | Description |
| POST/GET/DELETE | MCP Streamable HTTP (remote MCP transport) |
| GET | Natural language search (NO/EN) |
| POST | Structured filtering |
| GET | Producer details |
| GET | Platform statistics |
| POST | A2A JSON-RPC 2.0 |
| GET | A2A Agent Card |
| GET | MCP Server Card (human + machine-readable metadata) |
| GET | OpenAPI 3.1 spec |
| GET | AI-discovery index |
| GET | Privacy policy (NO/EN) |
Full spec: https://rettfrabonden.com/openapi.yaml
Architecture
TypeScript + Express on Fly.io
SQLite with WAL mode, persistent volume
MCP 2025-06-18 over Streamable HTTP + stdio (remote + local)
A2A v1.0.0 compliant (JSON-RPC 2.0 + Agent Card)
Value-based matching — no ads, no pay-to-rank
1,500+ agents across 374+ Norwegian cities
For producers
Your farm/market might already be listed. Visit https://rettfrabonden.com to check, and claim your agent to update your info and respond to buyer queries.
Troubleshooting
"The connector can't reach the server"
Check that your client is pointed at https://rettfrabonden.com/mcp (HTTPS, no trailing slash). The server uses the Streamable HTTP transport — stdio clients should use the lokal-mcp npm package instead.
"CORS error in the browser"
Browser-based MCP clients must send an Origin header. The server allow-lists https://claude.ai, https://www.claude.ai, https://chatgpt.com, and https://chat.openai.com. If you're hosting your own agent on a different origin, open an issue and we'll add it.
"tools/list returns an empty array"
Hit POST /mcp with a proper initialize request first and capture the Mcp-Session-Id response header. Subsequent calls must include that header — session IDs are sticky per connection.
"Search returns no results for a Norwegian query"
The server handles both NO and EN, but accents matter. Use økologisk rather than okologisk for best relevance. Try widening with lokal_discover — it accepts lat/lng + radius instead of free text.
"I claimed my agent but the dashboard is empty"
Claims are verified by email. Check spam for the verification code from kontakt@rettfrabonden.com. The token is valid for 24 hours.
Rate limits
Public endpoints allow 150 searches and 300 general API calls per 15-minute window. MCP tools/call counts against the search bucket. If your agent hits the limit, back off for 15 minutes — we don't block IPs, only throttle.
Still stuck Open an issue at https://github.com/slookisen/lokal/issues with the request payload (redact anything sensitive) and the response status code.
Privacy, Terms & Support
Privacy policy: https://rettfrabonden.com/privacy
Terms of service: https://rettfrabonden.com/terms
Issues / support: https://github.com/slookisen/lokal/issues
License
MIT
Available Tools
4 toolslokal_discoverBInspect
Structured search in the Lokal food producer registry. Filter by food categories, tags, and geographic distance. Returns ranked producers with contact info and vCard links.
Inputs: categories, tags, lat, lng, +2 more.
lokal_infoAInspect
Get detailed information about a specific Lokal producer — address, products, opening hours, certifications, and a vCard link the user can add to their contacts.
Inputs: agentId (required).
lokal_searchAInspect
Search for local food producers in Norway using natural language. Supports Norwegian and English. Returns ranked producers with contact info and a vCard link so the user can add them to their contacts. Examples: 'fresh vegetables near Grünerløkka', 'organic honey Oslo', 'ost Trondheim'.
Inputs: query (required), limit.
lokal_statsBInspect
Get Lokal platform statistics — total agents, cities covered, interactions.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools have overlapping purposes that could cause confusion. 'lokal_discover' and 'lokal_search' both search for producers, with 'discover' offering structured filtering and 'search' using natural language, making them potentially ambiguous. 'lokal_info' and 'lokal_stats' are distinct, but the two search tools may lead to misselection due to unclear boundaries in their use cases.
All tool names follow a consistent 'lokal_' prefix with a descriptive suffix pattern (e.g., discover, info, search, stats). This predictable verb_noun-like structure is clear and uniform throughout the set, with no deviations in style or convention.
With 4 tools, the count is reasonable and well-scoped for a food producer registry server. It covers key operations like searching, retrieving details, and getting platform stats, though it might feel slightly thin if more advanced features are expected, but overall it's appropriate for the domain.
The tool set covers basic search and retrieval functions but has notable gaps. There is no ability to create, update, or delete producer data, which limits CRUD coverage. However, for a read-only registry focused on discovery and information, it handles core workflows adequately, leaving agents to work around the lack of write operations.
Maintenance
Related MCP Connectors
Norwegian transport (Entur) and geodata (Kartverket): trips, departures, addresses, elevation.
Norwegian public data for AI agents: companies, tenders, addresses, laws, exchange rates.
Open guide to businesses in any country, plus Norwegian public services and parties. Never ranks.
Order from local Danish shops: products, pickup times, card payment and AltID age verification.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides LLM-friendly weather tools and Norwegian place name resolution via MCP, enabling weather forecasts, air quality, marine conditions, and activity planning.1MIT
- AlicenseBqualityBmaintenanceMCP server providing typed tools for Norwegian public data sources, enabling natural language queries to official datasets like SSB, Brønnøysund, MET, Kartverket, Entur, and more, without requiring API keys.47MIT
- AlicenseAqualityCmaintenanceEnables searching products, viewing product details, managing the basket, and accessing order history on nemlig.com through natural language. It does not support placing orders or accessing payment cards.642MIT
- AlicenseAqualityDmaintenanceEnables AI agents to access Norwegian public transport and geospatial data, including trip planning, stop departures, address search, elevation, and administrative boundaries, via the Entur and Kartverket APIs.2138 npmMIT