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: [email protected]

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.