@vmcsubastop/herald-mcp

HERALD MCP Server

MCP server for HERALD Feed — vehicle auction catalog and market valuations for Peru.

What it does

Gives AI agents (Claude, Gemini, etc.) direct access to:

• VMC Subastas auction catalog — live vehicle inventory with prices, auction status, and seller info
• AVT market valuations — conservative/market/optimistic price ranges for any make/model/year in Peru
• New listing monitoring — recently published vehicles entering the market
• Comparable data — VMC auction history + MercadoLibre listings backing each valuation

All prices in USD. Data updates in real-time via webhooks.

Tools

Tool	Description
herald_search_vehicles	Browse/filter the auction catalog (make, category, price, status)
herald_get_lot	Full details for a specific lot by ID
herald_new_listings	Recently published vehicles (last N hours)
herald_market_value	AVT valuation for make/model/year — price range + sell signal
herald_market_coverage	Available makes/models in the catalog
herald_health	Feed status, total lots, freshness

Setup

npm install
npm run build

Configuration

Set your API key:

export HERALD_API_KEY=your-key-here

Request an API key: [e-mail]

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "herald": {
      "command": "node",
      "args": ["/path/to/herald-mcp/dist/index.js"],
      "env": {
        "HERALD_API_KEY": "your-key-here"
      }
    }
  }
}

Usage with Claude Code

claude mcp add herald -- node /path/to/herald-mcp/dist/index.js

Attribution

Market valuations powered by AVT (Active Value Tracker) by Subastop S.A.C. Platform: VMC Subastas — Peru's leading vehicle auction platform.