# AutoPrivado

> Free tool for PRIVATE car sellers in Europe: decode a VIN or Dutch plate, get a rule-based price estimate, a listing in 7 languages (DE, FR, ES, IT, PL, NL, EN), posting kits per country – IT Subito (+AutoScout24.it), ES Wallapop (+coches.net), DE mobile.de (+Kleinanzeigen), FR leboncoin, NL Marktplaats (+AutoScout24.nl) – with three steps: open the form, copy the whole listing, save the photos (the seller publishes himself – AutoPrivado never posts to portals), one inbox per listing (car-{id}@in.autoprivado.com) that collects portal e-mails in the seller's account, contract templates (IT, ES, DE, FR Cerfa 15776 guide, NL) and registration checklists for DE, FR, ES, IT, PL, NL. Account optional (e-mail link or passkey), no payments. Listings and photos expire after 90 days; the owner can renew for 90 more days (one reminder 7 days before). Free-tier caps: up to 20 new listings per day; when a cap is reached the API answers 503 with error code `limit`.

Site: https://autoprivado.com (one site; language home pages /en/ /de/ /it/ /es/ /fr/ /nl/ /pl/). Operator: Nukehive OÜ, Estonia, info@autoprivado.com. Free, no API key, no commission. Prices are EUR, PLN for Poland, never converted.

## MCP server (Streamable HTTP, stateless JSON, no auth)
- Endpoint: https://autoprivado.com/mcp (POST JSON-RPC 2.0; GET answers 405)
- Registry name: com.autoprivado/autoprivado · server card: https://autoprivado.com/.well-known/mcp-server-card · docs: https://autoprivado.com/developers
- Read-only tools: search_listings (market, make, model, price range, currency, km, year, fuel), get_listing (id or URL), decode_vehicle (VIN via NHTSA vPIC, Dutch plate via RDW), estimate_price (VIN, plate or vehicle data + km + condition; rule-based ESTIMATE, not market data), list_portals (portals, listing forms and private-seller fees per country with sources), get_sale_documents (contract print link + registration checklist with deadlines)
- Write tool: create_listing – only on behalf of the car's owner. Returns the listing page and a private edit link for the seller; the listing stays out of search engines until the seller saves it on the site. AutoPrivado never posts to portals: the seller publishes there himself.
- Limits (free infrastructure): about 120 tool calls per 10 minutes per client, 3 new listings per client per hour, a small daily total of agent-created listings.
- Connect: Claude Code `claude mcp add --transport http autoprivado https://autoprivado.com/mcp` · Cursor / mcp.json `{"mcpServers":{"autoprivado":{"url":"https://autoprivado.com/mcp"}}}` · stdio-only clients `npx -y mcp-remote https://autoprivado.com/mcp`

## A2A
- Agent card: https://autoprivado.com/.well-known/agent-card.json (also /.well-known/agent.json); JSON-RPC https://autoprivado.com/a2a – SendMessage (1.0) or message/send (0.3) with a data part {"tool": "<read-only tool>", "arguments": {...}}

## REST API (JSON)
- POST /api/decode {vin} or {plate, country:"NL"} – NHTSA vPIC / RDW open data
- POST /api/estimate {vehicle:{year|firstRegistration, listPrice?}, km, condition, newPrice?} – rule-based ESTIMATE, not market data
- POST /api/listings {country, vin|plate, km, condition, price, alsoIn?:[other markets], altPrice?, equipment?, notes?, …} → {id, url, editUrl, editToken, kitUrls} – alsoIn: sell in other markets too (kits in their language); altPrice: price in the other currency (zł for PL, € otherwise), never converted
- GET /api/listings?q=&country=&minPrice=&maxPrice=&maxKm=&minYear=&fuel= – search; country also returns cross-listed cars (crossListed, marketPrice, marketCurrency)
- GET /api/listings/{id} – listing incl. texts in 7 languages (texts[lang].source: seller | ai | template; AI drafts from Cloudflare Workers AI, free allocation only, otherwise template) and missing-info checklist
- PATCH / DELETE /api/listings/{id} with header Authorization: Bearer {editToken}; PATCH {texts:{de:{title,body}}} edits a language (null resets), {equipment:"…"}, {regenerateTexts:true}
- POST /api/listings/{id}/photos (raw image/jpeg|png|webp, max 500 KB, Bearer token) – up to 15
- GET /api/listings/{id}/photos.zip
- GET /api/listings/{id}/kit?country={IT|ES|DE|FR|NL} → {country, recommended, optional, kits, markets, inbox, inboxState} and /api/listings/{id}/kit/{portal}
- POST /api/listings/{id}/renew (Bearer editToken) – extend listing + photos by 90 days (no-op while more than 89 days are left)
- POST /api/listings {…, whatsapp:"+39…", whatsappOk:true} – optional WhatsApp button on the listing page (international number + opt-in required)
- GET /api/contract/{IT|ES|DE|FR|NL}?listing={id} – printable contract HTML (print page: /contract/{CC}?listing={id})
- POST /api/listings/{id}/inquiries {name?, email, message} – message to the seller (only if the seller has an account; shown in the account inbox with label AutoPrivado)
- GET /api/contract/{DE|FR|ES|IT|NL|PL}?listing=&buyer={CC} – contract of the seller's country plus a two-language clause: seller's law governs (Rome I), buyer registers at home
- GET /api/checklist?country={DE|FR|ES|IT|PL|NL}&date=YYYY-MM-DD&lang=en|de – steps, documents, deadline dates

## Pages
- /l/{id}?lang=de|fr|es|it|pl|nl|en – public listing page with schema.org Car JSON-LD (410 Gone once deleted or expired)
- /search?q=&country= – cars for sale
- /new – create a listing (browser)
- /developers – MCP and API for developers
- /sitemap.xml, /robots.txt
- /kit/{id}?country=IT – posting kit: recommended + optional portal, three big buttons, collapsible field list, inbox address
- /renew/{id}?t= – confirm page from the reminder e-mail (renews only on POST)
- /impressum – legal notice (operator Nukehive OÜ)
- /checklist – registration checklist and deadline calculator
- /signin, /account – optional seller account (browser only; e-mail sign-in link or passkey); export and delete own data at /api/account/export and /api/account/delete