slookisen/lokal

**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,371+ 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/mcp
- **Transport:** 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:
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)
MCP Tools & Resources
The remote MCP endpoint at /mcp exposes four tools and two resources.
| Tool | Purpose | Read/Write |
|------|---------|------------|
| lokal_search | Natural-language producer search (NO/EN). Auto-starts a conversation with top matches so sellers can respond. | Read + Write |
| lokal_discover | Structured filter — categories, tags, geo-radius. Auto-starts conversations. | Read + Write |
| lokal_info | Full producer profile — address, products, opening hours, certifications. | Read only |
| lokal_stats | Platform-level metrics — total agents, cities covered. | Read only |
| Resource URI | Mime | Description |
|--------------|------|-------------|
| lokal://producers/overview | text/plain | Aggregate view of producers by city |
| lokal://producers/{agentId} | application/json | Detailed info about a specific producer |
HTTP API
| Endpoint | Method | Description |
|----------|--------|-------------|
| /mcp | POST/GET/DELETE | MCP Streamable HTTP (remote MCP transport) |
| /api/marketplace/search?q=... | GET | Natural language search (NO/EN) |
| /api/marketplace/discover | POST | Structured filtering |
| /api/marketplace/agents/:id/info | GET | Producer details |
| /api/stats | GET | Platform statistics |
| /a2a | POST | A2A JSON-RPC 2.0 |
| /.well-known/agent-card.json | GET | A2A Agent Card |
| /.well-known/mcp/server-card.json | GET | MCP Server Card (human + machine-readable metadata) |
| /openapi.yaml | GET | OpenAPI 3.1 spec |
| /llms.txt | GET | AI-discovery index |
| /privacy | GET | Privacy policy (NO/EN) |
Full spec: https://rettfrabonden.com/openapi.yaml
Architecture
- **TypeScript + Express** on Fly.io
- **SQLite** with WAL mode, persistent volume