VanAuto Campers

pl.vanautov0.3.1Updated Oct 6, 2026

Search VanAuto camper and rental listings: specs, photos, prices, equipment, contacts.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search VanAuto camper sale and rental listings, marketplace accessories, and price statistics from a public Polish API.

What it does
The server exposes read-only tools over the public VanAuto API: search_campers filters active sale or rental listings by text, make, model, type, fuel, gearbox, price, year, mileage, sleeping places and city; get_camper_details returns specs, photos, equipment and contacts for one listing; analyze_camper_prices and get_camper_market_stats give market statistics; find_similar_campers, list_camper_makes and list_camper_equipment support browsing. Marketplace tools cover accessory listings, sellers and wanted ads, and get_rental_reviews returns published rental reviews. Prompts generate Polish social posts, price checks, comparisons and SEO descriptions.
When to use it
Useful when an assistant needs to look up camper or rental offers, compare prices against a market cohort, or search marketplace accessories and wanted ads. It suits buyer research, listing comparison and Polish-language listing content generation.
Requirements
A remote Streamable HTTP endpoint at with no authentication, or a local Node.js stdio server. Local runs accept optional VANAUTO_API_URL and VANAUTO_SITE_URL environment variables. No account or API key is needed.
Before you install
Read-only: every call is an HTTP GET and no data is changed. Listing data is served in Polish and prices are in PLN. Photo thumbnails requested with includePhotos are fetched from the platform and passed to the model as image content. No credentials are requested by the public endpoint.

Installation

In SourceWeft

  1. Open VanAuto Campers in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "campers": {
      "type": "http",
      "url": "https://mcp.vanauto.pl/mcp"
    }
  }
}

README

VanAuto Campers MCP

Read-only MCP server that lets an AI client search and view VanAuto camper listings, rentals and marketplace (akcesoria) offers. It talks to the public VanAuto API, so it needs no credentials and cannot change any data.

Public endpoint: https://mcp.vanauto.pl/mcp (Streamable HTTP, no auth) Health check: https://mcp.vanauto.pl/health (uptime-checked every 6h via GitHub Actions) MCP Registry: pl.vanauto/campers — discoverable by registry-connected clients.

Tools

ToolWhat it does
search_campersSearch active sale or rental listings with filters: text, make, model, camper type, fuel, gearbox, state, price, year, mileage, sleeping places, city; rentals also support availability dates.
get_camper_detailsFull details for one listing by slug (auto-detects sale vs rental) or a camper spec sheet by cam_... id: decoded specs, photos, equipment, contact and links. includePhotos attaches 400px thumbnails as real images so multimodal models can look at them.
analyze_camper_pricesMarket price stats for a cohort (min/max/avg/median/p25/p75, average by year) and, optionally, how one listing compares (percentile, deviation from median).
find_similar_campersAlternatives the platform suggests for a sale listing.
list_camper_makesAll 200+ camper makes with active sale/rental counts, for resolving brand names.
list_camper_equipmentThe equipment catalog grouped by category.
get_camper_market_statsCurrent snapshot: active listing counts, campers by body type, makes with inventory.
get_rental_reviewsPublished customer reviews for a rental listing.
search_marketplace_listingsSearch marketplace accessories with text, manufacturer, category, condition, compatibility, price, location filters.
get_marketplace_listing_detailsFull accessory listing with seller info, shipping, photos, related offers.
get_marketplace_sellerSeller profile: trust badges, ratings, reputation and active offers.
search_wanted_adsMarketplace wanted ads (buyers looking for parts/accessories).

Prompts

Clients that support MCP prompts get one-click flows:

PromptWhat it does
social-postPulls the listing and writes a Polish Facebook/Instagram/OLX post with hashtags.
price-checkCompares a listing against its market cohort and gives a Polish verdict on the price.
compare-campersCompares 2-4 listings side by side against buyer needs.
seo-descriptionRewrites a listing description as an SEO-friendly Polish text.

Data is served in Polish (as on the site); prices are in PLN. Rental rows carry dailyRates (per-period rates) rather than a single price.

Connect a client

Remote (hosted)

OpenCode (~/.config/opencode/opencode.json):

json
{  "mcp": {    "vanauto-campers": {      "type": "remote",      "url": "https://mcp.vanauto.pl/mcp",      "enabled": true    }  }}

Claude / ChatGPT: add https://mcp.vanauto.pl/mcp as a custom connector.

Claude Desktop (older builds without native remote support):

json
{  "mcpServers": {    "vanauto-campers": {      "command": "npx",      "args": ["mcp-remote", "https://mcp.vanauto.pl/mcp"]    }  }}

Local (stdio)

Use an absolute path to src/server.js (see mcp.config.example.json):

json
{  "mcpServers": {    "vanauto-campers": {      "command": "node",      "args": ["/path/to/mcp-campers/src/server.js"],      "env": {        "VANAUTO_API_URL": "https://api.vanauto.pl",        "VANAUTO_SITE_URL": "https://vanauto.pl"      }    }  }}

Configuration

Env varDefaultPurpose
VANAUTO_API_URLhttps://api.vanauto.plAPI base URL. Point at http://localhost:3000 to use a local Rails server.
VANAUTO_SITE_URLhttps://vanauto.plFrontend base URL used to build listing links.

Development

sh
npm installnpm start            # stdio servernpm run dev          # local HTTP endpoint at http://127.0.0.1:8787/mcp (wrangler dev)

Checks

sh
npm run check            # syntax checknpm run smoke            # live tool checks against the configured APInpm run smoke:protocol   # MCP handshake + tools/list + tools/call over stdionpm run smoke:http       # same over HTTP: MCP_URL=https://mcp.vanauto.pl/mcp npm run smoke:http

Deployment

The server runs as a Cloudflare Worker (src/worker.js); the stdio entry (src/server.js) is for local clients. Both share the same tool factory in src/app.js.

sh
npx wrangler login       # once per machinenpx wrangler deploy      # deploys the Worker + mcp.vanauto.pl custom domain

Pushes to main deploy automatically via .github/workflows/deploy.yml, which needs two repository secrets:

SecretValue
CLOUDFLARE_API_TOKENAPI token with the Edit Cloudflare Workers template
CLOUDFLARE_ACCOUNT_IDCloudflare account id (Workers dashboard, right sidebar)

The workflow runs npm run smoke:http against https://mcp.vanauto.pl/mcp after each deploy.

MCP Registry

The server is published to the official MCP Registry as pl.vanauto/campers (namespace verified via a DNS TXT record on vanauto.pl). To publish a new version after changing server.json:

sh
# Signing key lives outside the repo, e.g. ~/.config/vanauto-mcp/registry-key.pemPRIVATE_KEY="$(openssl pkey -in ~/.config/vanauto-mcp/registry-key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"mcp-publisher login dns --domain vanauto.pl --private-key "$PRIVATE_KEY"mcp-publisher publish

Keep version in server.json in sync with package.json; the registry rejects duplicate versions.

Behaviour notes

  • Read-only. Every call is an HTTP GET against /public/...; there is no database access and no auth token.
  • One public surface. Only mcp.vanauto.pl serves the MCP; the workers.dev route is disabled so the zone rate-limit rule cannot be bypassed.
  • Caching. Catalog endpoints (makes, equipment) are cached in-process for an hour; searches and details for two minutes. The API itself also caches responses. On Workers, each isolate has its own short-lived instance of that cache.
  • Pagination. search_campers returns up to 50 rows plus a nextCursor; pass it back as after for the next page. Marketplace search is page-based (page, perPage).
  • Truncation. Long listing descriptions are trimmed (default 4000 chars, maxDescriptionChars to change), so one call cannot flood a model's context.
  • Photos. Photo URLs are always included; includePhotos additionally attaches up to 6 (default 3) 400px WebP thumbnails (~25 KB each) as MCP image content for multimodal models.
  • Tool failures come back as isError results with a readable message, e.g. a missing slug reports "No active sale or rental listing found with slug ...".

Source: README.md at commit 4975e55

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.3.1LatestOct 6, 2026