VanAuto Campers

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

Prompts

Clients that support MCP prompts get one-click flows:

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):

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

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

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

Development

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

Checks

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.

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:

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:

# 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 ...".