OpenVan.camp API for AI Agents

Discovery files

• /.well-known/ai-plugin.json — legacy AI plugin manifest
• /.well-known/openapi.json — compact OpenAPI for Custom GPT Actions and MCP servers (v1.1)
• /docs.openapi — the same endpoints in YAML, with request/response examples (Scribe-generated)
• /llms.txt — human-readable site index for LLMs
• /llms-full.txt — extended index with content
• /robots.txt — 27+ AI bots explicitly allowed

Public data endpoints

curl examples

# Cheapest diesel in Europe
curl 'https://openvan.camp/api/fuel/prices?source=my-agent' \
  | jq '.data | to_entries | map(select(.value.region=="europe")) | sort_by(.value.prices.diesel) | .[0:5]'

# Current fuel price keys returned by the API
curl 'https://openvan.camp/api/fuel/prices?source=my-agent' \
  | jq '.data.DE.prices | keys'

# Upcoming vanlife events in Germany
curl 'https://openvan.camp/api/events?country=DE&status=upcoming&source=my-agent'

# Compare food costs: Germany vs Turkey
curl 'https://openvan.camp/api/vanbasket/compare?from=DE&to=TR&source=my-agent'

# Today's van-travel weather score for Spain
curl 'https://openvan.camp/api/vansky/weather/ES?source=my-agent'

# Latest stories in French
curl 'https://openvan.camp/api/stories?locale=fr&limit=10&source=my-agent'

# How long a Russian passport may stay in Turkey, and how the days are counted
curl 'https://openvan.camp/api/visa/check?passport=RU&destination=TR&source=my-agent'

# Visa rules for a whole route in one call
curl 'https://openvan.camp/api/visa/route?t=RU,GE,TR&p=RU&source=my-agent'

# Fuel cost for a route (POST)
curl -X POST 'https://openvan.camp/api/route-cost?source=my-agent' \
  -H 'Content-Type: application/json' \
  -d '{"waypoints":["Berlin","Prague"],"cons":10,"fuel":"diesel","currency":"EUR"}'

Attribution & rate limits

• Pass ?source=<your-domain-or-app> on every request — it helps us track AI adoption and credit you in public reports.
• Rate limit: 120 requests/minute per IP for the endpoints above. Two compute-heavy ones are lower: POST /api/route-cost — 30/min, POST /api/visa/report/{locale} (PDF) — 12/min. Check the X-RateLimit-Remaining header.
• CORS is enabled for all /api/* and /.well-known/*.json — safe to call from browser-based agents.
• No API key, no signup, no authentication.
• Data updates: currency rates every 6 hours; weather every 3 hours for top destinations and twice a day worldwide; events and stories continuously; visa rules on source change (see /api/visa/history); fuel prices on a per-country verification cycle — daily to quarterly depending on how the country sets them. Fuel answers carry their own fetched_at and visa answers a meta.dataset block — trust those over this paragraph.

For Custom GPT builders

1. Open chat.openai.com/gpts/editor
2. In Actions → Import from URL, paste: https://openvan.camp/.well-known/openapi.json
3. Auth: None. Privacy: openvan.camp/en/privacy
4. Logo: vanlife-logo.png

Model Context Protocol (MCP)

@openvancamp/mcp-server exposes 14 read-only tools (fuel, weather, events, food index, currency, news, visa and vehicle-import rules) for any MCP-compatible host: Claude Desktop, Cursor, Windsurf, Continue, ChatGPT Apps SDK.

Remote (Streamable HTTP)

Hosted endpoint, no install — intended for ChatGPT Apps SDK and web-based agents:

https://mcp.openvan.camp/mcp

Local (stdio, via npx)

For Claude Desktop / Cursor / Windsurf add to your MCP config:

{
  "mcpServers": {
    "openvan": {
      "command": "npx",
      "args": ["-y", "@openvancamp/mcp-server"]
    }
  }
}

Source on GitHub: Kopaev/openvan-camp-public-api/mcp-server · npm: @openvancamp/mcp-server

Contact

Questions, integrations, rate-limit requests, corrections: hello@openvan.camp