🥬 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,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:

hljs language-json

{
  "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)

hljs language-bash

# 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"}'

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
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,386+ 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

lokal