de en es ja ko ru zh

OpenVan MCP Server

Name: OpenVan MCP Server
Author: Kopaev

by Kopaev

Overview Schema Related Servers Score Discussions

TypeScript

Remote

OpenVan.camp Public API

Free, no-auth API for vanlife data: fuel prices, currency rates, food cost index, vanlife events, and news stories — all in one place, no registration required.

Base URL: https://openvan.camp
Auth: None required
CORS: Enabled
License: data is CC BY 4.0; code in this repository (SDK, MCP server, examples) is MIT

JavaScript/TypeScript SDK: @openvancamp/sdk — npm install @openvancamp/sdk. Zero-config, typed, Node.js / browser / edge. SDK docs →

MCP Server (for AI agents): mcp-server/ — hosted at https://mcp.openvan.camp/mcp, also npx -y mcp-remote https://mcp.openvan.camp/mcp for Claude Desktop / Cursor / Windsurf. Install docs →

Custom GPT: OpenVan Travel Assistant — live in ChatGPT GPT Store.

What is authoritative

Resource	Purpose
This README	Quick overview and code examples
`/docs`	Interactive documentation with "Try it out"
`/docs.openapi`	Full OpenAPI 3.0 contract (always up to date)
`/docs.postman`	Postman collection

The OpenAPI spec at /docs.openapi is generated from the live codebase and is the authoritative contract. Numbers in this README (country counts, story totals) are approximate and updated periodically — check /api/fuel/prices meta or /api/stories pagination for current totals.

Related MCP server: APIbase

Endpoints

Endpoint	Description	Coverage
`GET /api/fuel/prices`	Retail fuel prices (gasoline, diesel, LPG, E85)	120+ countries
`GET /api/currency/rates`	Exchange rates relative to EUR	150+ currencies
`GET /api/vanbasket/countries`	Food price index relative to world average (100 = world avg)	90+ countries
`GET /api/vanbasket/compare?from=DE&to=TR`	Compare food costs between two countries	—
`GET /api/vanbasket/countries/{code}`	Single country + historical snapshots	—
`GET /api/events`	Vanlife events: expos, festivals, meetups, road trips	695 events
`GET /api/event/{slug}`	Full event details with geo coordinates	—
`GET /api/event/{slug}/articles`	Source articles linked to an event	—
`GET /api/stories`	News stories aggregated from 200+ publishers	8200+ stories
`GET /api/story/{slug}`	Full story with all source articles and direct links	—

Quick Start

# Fuel prices
curl https://openvan.camp/api/fuel/prices

# Currency rates (EUR-based)
curl https://openvan.camp/api/currency/rates

# Food price index
curl https://openvan.camp/api/vanbasket/countries

# Upcoming vanlife events in Germany
curl "https://openvan.camp/api/events?country=DE&status=upcoming&locale=en"

# Latest vanlife news stories in English
curl "https://openvan.camp/api/stories?locale=en"

Fuel Prices — `/api/fuel/prices`

Weekly retail prices from 45+ official government sources.
Cache TTL: 6 hours. Please poll no faster than every 10 minutes.

curl https://openvan.camp/api/fuel/prices

{
  "success": true,
  "data": {
    "DE": {
      "country_code": "DE",
      "country_name": "Germany",
      "region": "europe",
      "currency": "EUR",
      "local_currency": "EUR",
      "unit": "liter",
      "prices": {
        "gasoline": 1.79,
        "diesel": 1.69,
        "lpg": 0.89,
        "e85": null,
        "premium": null
      },
      "price_changes": { "gasoline": -0.02, "diesel": 0.01, "lpg": 0.0 },
      "fetched_at": "2026-04-05T10:00:00+00:00",
      "sources": ["EU Weekly Oil Bulletin", "Fuelo.net"],
      "sources_count": 2,
      "is_excluded": false
    }
  },
  "meta": {
    "total_countries": 121,
    "updated_at": "2026-04-05 10:00:00",
    "cache_ttl_hours": 6
  }
}

Notes:

unit is "liter" for most countries, "gallon" for US and Ecuador
is_excluded: true means the country has heavy fuel subsidies (prices don't reflect market rates)
price_changes = delta vs last week's prices

Currency Rates — `/api/currency/rates`

EUR-based exchange rates from multiple open-source providers with automatic fallback.
Cache TTL: 25 hours. Refreshed daily at 07:00 UTC.

curl https://openvan.camp/api/currency/rates

{
  "success": true,
  "rates": {
    "EUR": 1,
    "USD": 1.08,
    "GBP": 0.85,
    "TRY": 38.5,
    "GEL": 2.95,
    "KZT": 510,
    "RUB": 98.5
  },
  "cached": true,
  "updated_at": "2026-04-08T07:00:00+00:00"
}

Convert to any currency:

const priceInUSD = (priceEUR / rates.EUR) * rates.USD;
const priceInTRY = (priceEUR / rates.EUR) * rates.TRY;

VanBasket Food Price Index — `/api/vanbasket/*`

Relative cost of a food basket compared to world average (World = 100).
Based on World Bank ICP 2021 data, adjusted with IMF CPI.
Data source: CC BY 4.0

# All countries
curl https://openvan.camp/api/vanbasket/countries

# Compare two countries
curl "https://openvan.camp/api/vanbasket/compare?from=DE&to=TR"

# Single country with historical snapshots
curl https://openvan.camp/api/vanbasket/countries/DE

{
  "success": true,
  "data": {
    "CH": { "country_code": "CH", "country_name": "Switzerland", "vanbasket_index": 162.3, "pct_vs_world": 62.3 },
    "DE": { "country_code": "DE", "country_name": "Germany",     "vanbasket_index": 118.7, "pct_vs_world": 18.7 },
    "TR": { "country_code": "TR", "country_name": "Turkey",      "vanbasket_index":  82.4, "pct_vs_world": -17.6 },
    "GE": { "country_code": "GE", "country_name": "Georgia",     "vanbasket_index":  64.1, "pct_vs_world": -35.9 }
  },
  "meta": {
    "total_countries": 92,
    "world_avg": 100,
    "base_year": 2021,
    "source": "World Bank ICP 2021",
    "license": "CC BY 4.0"
  }
}

Compare response:

{
  "success": true,
  "data": {
    "from": { "country_code": "DE", "country_name": "Germany", "vanbasket_index": 118.7 },
    "to":   { "country_code": "TR", "country_name": "Turkey",  "vanbasket_index":  82.4 },
    "diff_percent": -30.6,
    "budget_100": 69,
    "cheaper": true
  }
}

budget_100: if you spend €100 on food in the from country, you'd spend €69 in the to country.

Events — `/api/events`

Vanlife events: exhibitions, festivals, meetups, road trips. Updated in real time.

Query params:

Param	Values	Default
`locale`	`en` `ru` `de` `fr` `es` `pt` `tr`	`en`
`status`	`upcoming` `ongoing` `past` `all`	`upcoming`
`type`	`expo` `festival` `forum` `meetup` `roadtrip`	—
`country`	ISO 3166-1 alpha-2	—
`search`	text	—
`page`	integer	`1`
`limit`	integer (max 100)	`30`

# Upcoming events in Germany
curl "https://openvan.camp/api/events?country=DE&status=upcoming&locale=en"

# Event details
curl "https://openvan.camp/api/event/fit-camper-2026?locale=en"

# Source articles linked to an event
curl "https://openvan.camp/api/event/fit-camper-2026/articles?locale=en"

{
  "events": [
    {
      "id": 493,
      "slug": "fit-camper-2026",
      "event_name": "Fit Your Camper",
      "event_type": "expo",
      "event_type_label": "Exhibition",
      "start_date": "2026-04-09",
      "end_date": "2026-04-12",
      "city": "Bologna",
      "country_code": "IT",
      "country": { "code": "it", "name": "Italy", "flag_emoji": "🇮🇹" },
      "venue_name": "BolognaFiere",
      "status": "upcoming",
      "articles_count": 7,
      "url": "https://openvan.camp/en/event/fit-camper-2026"
    }
  ],
  "pagination": { "total": 48, "page": 1, "limit": 30, "pages": 2 }
}

Notes:

Unknown or missing locale silently falls back to en
/api/event/{slug}/articles returns source articles filtered by locale; if none match, all articles are returned (may be in the original publisher language)

Stories / News — `/api/stories`

Vanlife news stories aggregated from 200+ publishers and translated into 7 languages. Each story clusters multiple source articles covering the same topic.

Query params:

Param	Values	Default
`locale`	`en` `ru` `de` `fr` `es` `pt` `tr`	`en`
`category`	category slug (e.g. `camping`, `travel`, `gear`, `incident`)	—
`country`	ISO 3166-1 alpha-2	—
`search`	text	—
`page`	integer	`1`
`limit`	integer (max 50)	`20`

# Latest stories in English
curl "https://openvan.camp/api/stories?locale=en"

# German vanlife news in Germany
curl "https://openvan.camp/api/stories?locale=de&country=DE"

# Full story with all source links
curl "https://openvan.camp/api/story/free-overnight-parking-netherlands?locale=en"

{
  "slug": "free-overnight-parking-netherlands",
  "title": "Free Overnight Parking for Motorhomes in the Netherlands",
  "summary": "The Dutch motorhome community is pushing for more designated free overnight spots...",
  "image_url": "https://...",
  "category": { "slug": "travel", "name": "Travel" },
  "countries": [{ "code": "nl", "name": "Netherlands", "flag_emoji": "🇳🇱" }],
  "first_published_at": "2026-04-01T10:00:00+00:00",
  "last_updated_at": "2026-04-03T08:00:00+00:00",
  "articles_count": 5,
  "url": "https://openvan.camp/en/news/travel/free-overnight-parking-netherlands",
  "sources": [
    {
      "title": "Gratis overnachten in je camper: de beste plekken",
      "original_url": "https://www.campermagazine.nl/overnachten/gratis-plaatsen",
      "source_name": "CamperMagazine.nl",
      "published_at": "2026-04-01T10:00:00+00:00",
      "language": "nl",
      "image_url": "https://..."
    }
  ]
}

Notes:

title and summary are translated to the requested locale
sources[].language is always the original publisher language, regardless of locale
sources[].original_url is the direct link to the publisher article

Response Format

All JSON endpoints follow a consistent envelope:

{ "success": true, "data": { ... }, "meta": { ... }, "_attribution": { ... } }

Every response includes an _attribution object:

"_attribution": {
  "data_source": "openvan.camp",
  "license": "CC BY 4.0",
  "attribution_url": "https://openvan.camp/",
  "attribution_html": "Data: <a href=\"https://openvan.camp/\">OpenVan.camp</a> (CC BY 4.0)"
}

Errors:

{ "success": false, "error": "Description of the error." }

If you call without Accept: application/json, some error responses may return HTML. Always send the header:

Accept: application/json

Rate Limiting

120 requests per minute per IP. Please be responsible:

Cache fuel prices for at least 6 hours
Cache currency rates for at least 1 hour
Cache stories/events for at least 15 minutes

Attribution

Required by CC BY 4.0. Suggested format:

Data: <a href="https://openvan.camp/">OpenVan.camp</a> — CC BY 4.0

Identify your integration

Pass ?source=yoursite.com with any request — no registration needed. Your value is echoed back as _attribution.your_source so you can verify it's working:

curl "https://openvan.camp/api/fuel/prices?source=myapp.com"

{
  "success": true,
  "data": { "..." },
  "meta": { "..." },
  "_attribution": {
    "data_source": "openvan.camp",
    "license": "CC BY 4.0",
    "attribution_url": "https://openvan.camp/",
    "attribution_html": "Data: <a href=\"https://openvan.camp/\">OpenVan.camp</a> (CC BY 4.0)",
    "your_source": "myapp.com"
  }
}

This helps us understand how the data is being used and acknowledge active projects.

JavaScript / TypeScript SDK

npm install @openvancamp/sdk
# or: pnpm add @openvancamp/sdk

import { OpenVan } from "@openvancamp/sdk";

const ov = new OpenVan();

// Cheapest diesel in Europe (top 5, EUR-normalized)
const top5 = await ov.fuel.cheapest("diesel", 5);
top5.forEach(c => console.log(c.country_name, c.prices.diesel, c.currency));

// Is Portugal cheaper than Germany for van living?
const comp = await ov.basket.compare("DE", "PT");
console.log(`Portugal is ${Math.abs(comp.diff_percent)}% cheaper`);

// Vanlife weather suitability — top 10 countries right now
const weather = await ov.weather.top({ limit: 10 });

ESM-native, fully typed (TypeScript included), works in Node.js ≥ 18, browser, Cloudflare Workers, Deno, Bun. No API key.

npm: @openvancamp/sdk · Full SDK docs →

Resources

Interactive docs: https://openvan.camp/docs
OpenAPI 3.0 spec: https://openvan.camp/docs.openapi
Postman collection: https://openvan.camp/docs.postman
JavaScript SDK: https://www.npmjs.com/package/@openvancamp/sdk
Developer page: https://openvan.camp/en/developers

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

API Aggregator MCP Server
Weather Services Finance Search
mfang0126
F
license
-
quality
D
maintenance
A Model Context Protocol (MCP) Server that provides unified access to multiple external APIs (weather, news, financial data) through a single, consistent interface for AI agents and LLMs.
Last updated 2025-07-04
1
APIbase
App Automation Databases Finance
whiteknightonhorse
A
license
A
quality
B
maintenance
Unified MCP gateway for AI agents with 56+ tools and growing. Travel (Amadeus, Sabre GDS), e-commerce, local services, financial markets (Polymarket), and marketing APIs — all through a single endpoint. Pay-per-call via x402 micropayments in USDC.
Last updated 2026-07-02
100
1
9
MIT
bybit-trading
Cryptocurrency Finance Autonomous Agents
Vanszs
A
license
-
quality
D
maintenance
MCP server for cryptocurrency trading across multiple exchanges (Bybit, Binance, KuCoin, etc.) with real-time price data, comparison, and natural language query support. Integrates with AI assistants via the Model Context Protocol.
Last updated 2025-09-27
MIT
OpenWeather-OneCall3-MCP
Weather Services Location Services
Hakuin123
F
license
-
quality
D
maintenance
A Model Context Protocol (MCP) server that provides weather data using the OpenWeather One Call API 3.0. This server allows AI agents to access current weather, forecasts, and historical weather data for any location.
Last updated 2026-02-20
2

View all related MCP servers

Related MCP Connectors

Reasoning Commons
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
mcp-server
Read-only MCP server for Muovi, Argentina's trust-first local services marketplace (6 tools).
ToolAPI
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

View all MCP Connectors

Appeared in Searches

Current oil price lookup

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kopaev/openvan-camp-public-api'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

OpenVan.camp Public API

What is authoritative

Endpoints

Quick Start

Fuel Prices — /api/fuel/prices

Currency Rates — /api/currency/rates

VanBasket Food Price Index — /api/vanbasket/*

Events — /api/events

Stories / News — /api/stories

Response Format

Rate Limiting

Attribution

Identify your integration

JavaScript / TypeScript SDK

Resources

Maintenance

Resources

Looking for Admin?

Related MCP Servers

API Aggregator MCP Server

APIbase

bybit-trading

OpenWeather-OneCall3-MCP

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

Fuel Prices — `/api/fuel/prices`

Currency Rates — `/api/currency/rates`

VanBasket Food Price Index — `/api/vanbasket/*`

Events — `/api/events`

Stories / News — `/api/stories`