# @vmcsubastop/herald-mcp

MCP server for HERALD Feed — vehicle auction catalog and market valuations for Peru (VMC Subastas + AVT). Sellers of disused assets: subastop.com

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 1.2.0
- **Author:** Subastop S.A.C.
- **License:** MIT
- **npm:** @vmcsubastop/herald-mcp
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 0 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-12T09:16:16.913Z
- **Version scanned:** 1.2.0
- **CVEs:** none found by OSV at scan time

## Tools

9 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `herald_search_vehicles` — Search the VMC Subastas vehicle auction catalog. Returns vehicles available at auction in Peru with prices in USD. Filters by make, category, status, and price 
- `herald_get_lot` — Get full details for a specific vehicle lot on VMC Subastas by its lot ID. Returns make, model, year, base price (USD), AVT market reference price, auction stat
- `herald_new_listings` — Get recently published vehicles on VMC Subastas. Shows new auction inventory added in the last N hours. Useful for monitoring new inventory entering the market.
- `herald_market_value` — Get the AVT market valuation for a vehicle in Peru. Returns conservative/market/optimistic price range in USD, seasonal sell signal, and comparable data from VM
- `herald_market_coverage` — Discover which vehicle makes and models are available in the HERALD catalog. Returns all makes with their models, lot counts, and year ranges. Use this before r
- `herald_health` — Check HERALD Feed service health. Returns total lots, active lots, last sync time, and data freshness. No authentication required. Use this to verify the feed i
- `herald_search_resources` — Find published SubasBlog articles about selling idle assets, fleets, machinery or buying at auction. Returns summaries, source URLs and contact/catalog links. E
- `herald_create_lead` — Register a buyer or seller contact request with VMC. First show the user exactly what contact and interest data will be shared with VMC through its commercial S
- `herald_get_lead_status` — Get the status of a request created by this authenticated agent. Contains no contact details. Delivered means posted to the commercial channel; contacted, oppor

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"herald\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@vmcsubastop/herald-mcp\"\n      ],\n      \"env\": {\n        \"HERALD_REGISTRATION_KEY\": \"<YOUR_HERALD_REGISTRATION_KEY>\",\n        \"HERALD_API_KEY\": \"<YOUR_HERALD_API_KEY>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `HERALD_REGISTRATION_KEY` — Herald Registration Key (optional)
- `HERALD_API_KEY` — Herald API Key (optional)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 2 credentials (0 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Moderate blast radius — holds an api key; runs on your machine.
- Floor 25, ceiling 25 (tier: moderate)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/%40vmcsubastop%2Fherald-mcp
- Install plan: https://forgeregistry.com/api/v1/packages/%40vmcsubastop%2Fherald-mcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/%40vmcsubastop%2Fherald-mcp
- HTML page: https://forgeregistry.com/registry/%40vmcsubastop%2Fherald-mcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.
