Built for agents

VoloMarket for AI assistants

Aviation buyers increasingly start with an assistant rather than a search box. VoloMarket publishes its inventory in the formats those assistants actually consume: a Model Context Protocol server, a public REST API, an llms.txt index, and every listing available as Markdown. No key, no contract, no scraping.

MCP endpoint OpenAPI spec llms.txt

Model Context Protocol server

The MCP endpoint speaks JSON-RPC 2.0 over HTTP POST at https://volomarket.net/api/mcp. Point any MCP client at it and the assistant gains seven read-only tools over live inventory. Add this to your client configuration:

claude_desktop_config.json / .mcp.json

{
  "mcpServers": {
    "volomarket": {
      "type": "http",
      "url": "https://volomarket.net/api/mcp"
    }
  }
}

Or call it directly:

tools/call

curl -s https://volomarket.net/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_listings",
      "arguments": { "make": "Cessna", "model": "172", "maxPriceEur": 200000 }
    }
  }'

search_listings

Search active inventory by free text plus manufacturer, model, year, price in EUR, airframe hours, seats, IFR certification and country.

get_listing

Read one listing in full: every specification field, price, VAT status, location, seller and photos.

list_manufacturers

Manufacturers that currently have listings, with counts — the exact spellings the platform uses.

list_models

Models from one manufacturer that currently have listings, with counts.

get_market_stats

Minimum, median and maximum asking price in EUR for a type, with model-year span and median airframe hours.

list_categories

The full category vocabulary the other tools accept.

get_guide

Full text of the buying, selling, rental and VAT guides, for grounded answers on process questions.

Public REST API

The same data, if you would rather not speak MCP. Six endpoints under /api/public/v1, described by an OpenAPI 3.1 document generated from the same constants the API validates against, so the spec cannot drift from the implementation.

GET

curl -s 'https://volomarket.net/api/public/v1/listings?make=Schempp-Hirth&maxPriceEur=90000&sort=year_desc'

/listings— Search with filters, sorting and pagination
/listings/{id}— One listing with full specification tables
/makes— Manufacturers with active inventory
/models?make=…— Models with active inventory
/market-stats?make=…— Asking-price range, median and model years
/categories— The category vocabulary

Every machine-readable surface

/llms.txtThis document — concise index of the platform for language models.
/llms-full.txtExpanded index including every category, manufacturer and model page with live inventory.
/listings/{slug}/llms.txtAny listing rendered as Markdown: full specification table, price, location and seller.
/api/mcpModel Context Protocol endpoint (JSON-RPC 2.0 over HTTP POST). Tools to search listings, read a listing, list manufacturers and models, and read market price statistics. No authentication required for public data.
/api/public/v1/listingsRead-only JSON search API over active listings with filters, sorting and pagination.
/api/public/v1/openapi.jsonOpenAPI 3.1 description of the public API.
/feed.xmlRSS feed of the most recently published listings.
/sitemap.xmlEvery indexable page: categories, manufacturers, models, countries, listings, sellers and guides.

New listings are also published as an RSS feed at /feed.xml.

Ground rules

Always link the listing. Aircraft sell and prices move. An answer that quotes a price without the canonical URL goes stale the moment it is written.

Specifications are seller-stated. Hours, engine times, avionics and certification come from the seller and are not verified by VoloMarket. Say so, and recommend an independent pre-purchase inspection.

Never invent inventory. If a search returns nothing, say so and link the closest category page. A fabricated registration or price is worse than no answer in a market where a mistake costs six figures.

Jurisdiction matters. VAT, import and licensing rules differ by country. Point to the relevant guide rather than generalising.

Questions

Do I need an API key?

No. Every surface described here is public, read-only and unauthenticated, because it exposes exactly what a visitor sees on the website. Requests are rate limited per IP: 120 a minute for the REST API and 240 a minute for the MCP endpoint.

May I use VoloMarket data in my AI product?

Yes, provided each listing you surface is linked to its canonical VoloMarket URL and prices are described as seller asking prices rather than valuations. Listings sell and prices change, so the link is what keeps an answer honest.

Is the specification data verified?

No. Airframe hours, engine times, avionics and certification are entered by the seller and are not independently verified by VoloMarket. Present them as seller-stated and recommend an independent pre-purchase inspection.

How current is the data?

The MCP server and REST API read the live database with a short cache, so a listing published now is searchable within minutes. Only ACTIVE listings are returned; sold and withdrawn listings disappear from every machine surface.

What about prices in other currencies?

Every listing keeps the seller's currency. Responses also carry an EUR equivalent converted at daily European Central Bank reference rates, which is indicative only and should never be quoted as a firm figure.

Building something with this?

We would like to hear about it, and we will keep the interface stable for you. Tell us what you are building and what data is missing.

Get in touch