{"name":"HERALD Feed — VMC Subastas","description":"Machine-readable vehicle auction data and market valuations for Peru. Powered by AVT (Active Value Tracker de Subastop).","version":"2.0.0","base_url":"https://feed.vmcsubastas.com","endpoints":{"issue_token":{"method":"POST","path":"/herald/v1/tokens/issue","auth":"X-Herald-Registration-Key","description":"Mint a HERALD JWT (Bearer) for a registered consumer"},"revoke_token":{"method":"POST","path":"/herald/v1/tokens/revoke","auth":"Bearer (admin:revoke)","description":"Revoke an existing HERALD JWT by jti"},"jwks":{"method":"GET","path":"/herald/v1/jwks.json","auth":"none","description":"Public JWKS for verifying HERALD-issued tokens (RFC 7517)"},"catalog":{"method":"GET","path":"/herald/v1/lots","auth":"Bearer (lots:read)","description":"Current catalog (upcoming + active lots)"},"lot_detail":{"method":"GET","path":"/herald/v1/lots/{lotId}","auth":"Bearer (lots:read)","description":"Single lot detail"},"new_listings":{"method":"GET","path":"/herald/v1/new","auth":"Bearer (lots:read)","description":"Recently published (last 24h)"},"health":{"method":"GET","path":"/herald/v1/health","auth":"none","description":"Service health and freshness"},"market_coverage":{"method":"GET","path":"/herald/v1/market/coverage","auth":"Bearer (market:read)","description":"AVT makes + model counts"},"market_make":{"method":"GET","path":"/herald/v1/market/{make}","auth":"Bearer (market:read)","description":"Models for a make with years"},"market_model":{"method":"GET","path":"/herald/v1/market/{make}/{model}","auth":"Bearer (market:read)","description":"Model valuation across years"},"market_year":{"method":"GET","path":"/herald/v1/market/{make}/{model}/{year}","auth":"Bearer (market:read)","description":"Exact year valuation + comparables"},"events_log":{"method":"GET","path":"/herald/v1/events","auth":"Bearer (events:subscribe)","description":"Paginated event log"},"events_stream":{"method":"GET","path":"/herald/v1/events/stream","auth":"Bearer (events:subscribe)","description":"SSE real-time event stream"},"events_status":{"method":"GET","path":"/herald/v1/events/status","auth":"Bearer (events:subscribe)","description":"Active subscriber count"},"register_webhook":{"method":"POST","path":"/herald/v1/events/subscribers","auth":"Bearer (events:subscribe)","description":"Register webhook subscriber"},"list_webhooks":{"method":"GET","path":"/herald/v1/events/subscribers","auth":"Bearer (events:subscribe)","description":"List webhook subscribers"},"delete_webhook":{"method":"DELETE","path":"/herald/v1/events/subscribers/{id}","auth":"Bearer (events:subscribe)","description":"Unregister webhook"},"reactivate_webhook":{"method":"POST","path":"/herald/v1/events/subscribers/{id}/reactivate","auth":"Bearer (events:subscribe)","description":"Reset circuit breaker"},"sync":{"method":"GET","path":"/herald/sync","auth":"Bearer","description":"Manual catalog sync trigger"},"enrich":{"method":"GET","path":"/herald/enrich-thumbnails","auth":"Bearer","description":"Batch thumbnail backfill"},"catalog_html":{"method":"GET","path":"/catalog","auth":"none","description":"HTML + schema.org JSON-LD for crawlers"}},"discovery":{"llms_txt":"/llms.txt","llms_full_txt":"/llms-full.txt","openapi":"/openapi.json","ai_plugin":"/.well-known/ai-plugin.json","sitemap":"/sitemap.xml","catalog_html":"/catalog","dashboard":"/herald/dashboard"},"mcp_server":{"package":"@vmcsubastop/herald-mcp","registry":"io.github.pinz-byte/herald-vehicle-auction","install":{"claude_desktop":{"command":"npx","args":["-y","@vmcsubastop/herald-mcp"],"env":{"HERALD_API_KEY":"<your-key>"}},"cli":"npx -y @vmcsubastop/herald-mcp"},"tools":["herald_search_vehicles","herald_get_lot","herald_new_listings","herald_market_value","herald_market_coverage","herald_health"]},"auth":{"type":"oauth2-bearer","scheme":"Bearer","token_endpoint":"/herald/v1/tokens/issue","jwks_uri":"/herald/v1/jwks.json","scopes":["lots:read","market:read","events:subscribe","health:read","admin:revoke"],"token_lifetime_seconds":900,"legacy_fallback":{"type":"api-key","header":"X-Herald-Key","status":"transition-only"},"contact":"pinzon@subastop.com"},"platform":"https://www.vmcsubastas.com"}