assetvaluation-mcp

A stdio MCP (Model Context Protocol) server that exposes AssetValuation's Canadian market valuation API as tools for LLM agents (Claude Desktop, Claude Code, Cursor, and any other MCP-compatible client).

What you get

Three read-only tools that proxy AssetValuation's HTTP API:

| Tool | What it does | Inputs | | --- | --- | --- | | value_vehicle | Get a Canadian market valuation, dealer math, and lender decision for a vehicle. | vehicle (VIN or year+make+model+vehicle_type), optional purpose, merchant_listed_price_cad, merchant_name, merchant_url. | | max_buy_price | Compute a dealer's maximum bid for a vehicle given target gross, recon, days on lot, and floorplan rate. Returns sensitivity table. | vehicle, dealer_inputs, optional retail_target_cad. | | health_check | Confirm the configured AssetValuation API endpoint is reachable. | (none) |

Supported vehicle types: powersports (motorcycle, ATV, UTV, snowmobile, PWC, dirt bike, mini bike), marine (boat, sail boat, outboard motor), auto (car, truck, conversion van), RV family (RV, motor home A/B/C, travel trailer, fifth wheel, truck camper, folding camper), and niche (trailer, garden tractor, recreational equipment).

Install

npm install -g assetvaluation-mcp

Or run via npx without installing globally:

npx -y assetvaluation-mcp

Requires Node.js 20 or later.

Configuration

The server reads two environment variables:

| Variable | Required | Default | Notes | | --- | --- | --- | --- | | ASSETVALUATION_API_KEY | yes | (none) | Your AssetValuation API key. | | ASSETVALUATION_BASE_URL | no | https://assetvaluation.ca | Override for staging or self-hosted deployments. No trailing slash. |

If ASSETVALUATION_API_KEY is not set, the server still boots so the harness can list tools, but each tool call returns a clear "API key not set" error.

Claude Code

claude mcp add assetvaluation -s user -- npx -y assetvaluation-mcp

Set the API key separately, or include it inline:

claude mcp add assetvaluation -s user -e ASSETVALUATION_API_KEY=av_... -- npx -y assetvaluation-mcp

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) and add:

{
  "mcpServers": {
    "assetvaluation": {
      "command": "npx",
      "args": ["-y", "assetvaluation-mcp"],
      "env": {
        "ASSETVALUATION_API_KEY": "av_..."
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Edit .cursor/mcp.json in your workspace (or ~/.cursor/mcp.json for global) and add:

{
  "mcpServers": {
    "assetvaluation": {
      "command": "npx",
      "args": ["-y", "assetvaluation-mcp"],
      "env": {
        "ASSETVALUATION_API_KEY": "av_..."
      }
    }
  }
}

Tool reference

value_vehicle

Get a Canadian market valuation. Either supply a 17-character VIN (12-character HIN for marine craft) or year+make+model. vehicle_type is always required so the API knows which identifier rules apply.

Optional inputs unlock additional behavior:

• purpose (new_loan, refi, collateral_review, repo_appraisal) anchors the recommended value to a different condition grade.
• merchant_listed_price_cad, merchant_name, merchant_url activate the decision engine, which compares the merchant price against comp medians and produces an approve / supervisor_review / advise_partner / request_clarification verdict.

Returns recommended value, wholesale/retail/spread, days-on-lot forecast, trade-in band, decision (when applicable), per-source confidence, and any warnings.

max_buy_price

Compute a dealer's ceiling bid working backward from the retail target.

dealer_inputs requires:

• target_gross_cad: target gross profit in CAD.
• recon_estimate_cad: estimated reconditioning cost.
• target_dom_days: target days on lot (1 to 365).
• floorplan_rate_apr: floorplan financing APR as a decimal (e.g., 0.085 for 8.5%).
• auction_fees_cad, transport_cost_cad (optional, default 0).

If retail_target_cad is omitted, the API derives it from its own valuation pipeline. Returns max_buy_price plus a sensitivity table showing how max_buy moves when each input shifts by +/-10%.

health_check

No inputs. Returns the overall ok flag plus per-adapter status. Use this to confirm the configured base URL and API key are reachable.

Output formats

Every tool accepts a response_format parameter ("markdown" default, or "json"). The structured response is also always returned via the MCP structuredContent field, regardless of response_format.

Development

git clone https://github.com/xmabdelrahman/AssetValuation.git
cd AssetValuation/mcp
npm install
npm test
npm run build
node dist/index.js   # boots the stdio server on stdin/stdout

Smoke-test the built binary:

ASSETVALUATION_API_KEY=av_test node dist/index.js

You should see assetvaluation-mcp v0.1.0 ready (stdio) on stderr. The server is now waiting for JSON-RPC messages on stdin.

License

MIT