TradeBasis US Market Appraisal
Free US vehicle averages in USD from matched asking prices. VIN optional; limited public pilot.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~2,097Tokens (tool definitions)
~25.1 KBTypical response size
Moderate attention impact (1.64% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"market-appraisal": {
"url": "https://tradebasis.net/mcp/appraisal"
}
}
}Remote endpoints
https://tradebasis.net/mcp/appraisalstreamable-httpWhat it can do
Tool inventory
Tools (1)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢appraise_vehicle(vin, year, make, model, trim, ...)
A derived TradeBasis asking-price market average. Supply odometerMiles plus either vin or all of year, make, model and trim. Ask the user for missing details; never invent vehicle identity or mileage. VIN-assisted decoding may still require a confirmed trim, fuelType or bodyStyle. If supplied identity conflicts with the VIN, ask the user to verify the VIN and conflicting fields; do not choose silently or retry unchanged. Omit market for nationwide US. Not a trade-in offer or completed-sale value.
Input Schema
{
"type": "object",
"properties": {
"vin": {
"type": "string",
"minLength": 1,
"maxLength": 30,
"description": "VIN-assisted input: provide the vehicle's 17-character VIN with odometerMiles. Optional for complete manual input. Decoding may leave trim, fuelType or bodyStyle unresolved; ask the user to confirm them, never guess. If decoding fails, confirm the VIN or omit vin and use complete manual input. Supplied identity must agree with the VIN."
},
"year": {
"type": "integer",
"description": "Confirmed model year. Required without vin; optional with vin, but must agree with the decoded year. Ask the user if unknown."
},
"make": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "Confirmed vehicle manufacturer. Required without vin; optional with vin, but must agree with the decoded make."
},
"model": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Confirmed US model name. Required without vin; optional with vin, but must agree with the decoded model."
},
"trim": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Confirmed exact trim, including meaningful +, hyphens and powertrain qualifiers. Required without vin. With vin, supply it if decoding does not identify one unambiguous trim; never assume Base or choose from a decoded list."
},
"odometerMiles": {
"type": "number",
"minimum": 0,
"maximum": 600000,
"description": "Current odometer reading in miles, required for BOTH input paths. Ask the user; never estimate mileage from the VIN or model year. Zero is valid only when actually reported."
},
"market": {
"type": "string",
"maxLength": 60,
"description": "Optional US state name or two-letter state code, not the user's precise location. Omit for nationwide US."
},
"fuelType": {
"type": "string",
"enum": [
"Gasoline",
"Diesel",
"Hybrid",
"Plug-in Hybrid",
"Electric"
],
"description": "Optional confirmed powertrain/fuel type. Required later if identity is ambiguous. Ask the user rather than selecting a default; must agree with a reported VIN powertrain."
},
"bodyStyle": {
"type": "string",
"maxLength": 50,
"description": "Optional confirmed body style: sedan, hatchback, coupe, convertible, SUV, pickup, wagon, minivan or van. Required later if identity is ambiguous; ask the user and do not contradict the VIN."
}
},
"required": [
"odometerMiles"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"anyOf": [
{
"required": [
"year",
"make",
"model",
"trim"
]
},
{
"required": [
"vin"
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"schemaVersion": {
"type": "string",
"const": "1.0"
},
"outcome": {
"type": "string",
"enum": [
"COMPLETE",
"INVALID_INPUT",
"CLARIFICATION_REQUIRED",
"INPUT_CONFLICT",
"NO_MATCHES",
"INSUFFICIENT_EVIDENCE",
"PROVIDER_FAILURE",
"TIMEOUT",
"CANCELLED",
"DISABLED",
"DAILY_LIMIT",
"ATTEMPT_LIMIT",
"BUSY",
"METER_UNAVAILABLE"
]
},
"message": {
"type": "string",
"minLength": 1
},
"retryable": {
"type": "boolean"
},
"automaticRetryAllowed": {
"type": "boolean",
"const": false,
"description": "Recoverability never authorizes automatic paid searches."
},
"nextAction": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"NONE",
"ASK_USER",
"REVIEW_INPUT",
"RETRY_LATER",
"STOP",
"USE_WEBSITE",
"WAIT_FOR_RESET"
]
},
"message": {
"type": "string",
"minLength": 1
}
},
"required": [
"type",
"message"
],
"additionalProperties": false
},
"retryAt": {
"type": "string",
"format": "date-time"
},
"clarificationFields": {
"type": "array",
"items": {
"type": "string"
}
},
"subject": {
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1886
},
"make": {
"type": "string",
"minLength": 1
},
"model": {
"type": "string",
"minLength": 1
},
"trim": {
"type": "string",
"minLength": 1
},
"odometerMiles": {
"type": "number",
"minimum": 0,
"maximum": 600000
},
"identitySource": {
"type": "string",
"enum": [
"manual",
"vin-assisted"
]
},
"fuelType": {
"type": "string"
},
"bodyStyle": {
"type": "string"
}
},
"required": [
"year",
"make",
"model",
"trim",
"odometerMiles",
"identitySource"
],
"additionalProperties": false
},
"currency": {
"type": "string",
"const": "USD"
},
"odometerUnit": {
"type": "string",
"const": "miles"
},
"marketScope": {
"type": "string",
"const": "US"
},
"requestedMarket": {
"type": "string",
"minLength": 1
},
"actualMarket": {
"type": "string",
"minLength": 1,
"description": "Geography reported for the selected evidence; unknown listing states are explicitly identified."
},
"searchMarket": {
"type": "string",
"minLength": 1,
"description": "Broadest provider search scope; not a claim about every selected listing."
},
"calculatedAt": {
"type": "string",
"format": "date-time"
},
"evidenceCount": {
"type": "integer",
"minimum": 0
},
"baseMarketAverage": {
"type": "integer",
"exclusiveMinimum": 0
},
"mileageAdjustment": {
"type": "integer"
},
"mileageAdjustedMarketAverage": {
"type": "integer",
"exclusiveMinimum": 0
},
"mileageAdjustmentAvailable": {
"type": "boolean"
},
"mileageAdjustmentUnavailableReason": {
"type": "string",
"enum": [
"NO_VALUATION",
"SUBJECT_MILEAGE_ZERO",
"COMPARABLE_MILEAGE_UNAVAILABLE"
]
},
"yearBracketUsed": {
"type": "boolean"
},
"excludedCount": {
"type": "integer",
"minimum": 0
},
"methodology": {
"type": "string",
"minLength": 1
},
"referralId": {
"type": "string",
"format": "uuid"
}
},
"required": [
"schemaVersion",
"outcome",
"message",
"retryable",
"automaticRetryAllowed",
"nextAction",
"currency",
"odometerUnit",
"marketScope",
"requestedMarket",
"calculatedAt",
"evidenceCount",
"mileageAdjustmentAvailable",
"yearBracketUsed",
"excludedCount",
"methodology"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"allOf": [
{
"if": {
"properties": {
"outcome": {
"const": "COMPLETE"
}
}
},
"then": {
"required": [
"subject",
"actualMarket",
"baseMarketAverage"
],
"properties": {
"evidenceCount": {
"minimum": 5
},
"mileageAdjustmentUnavailableReason": {
"enum": [
"SUBJECT_MILEAGE_ZERO",
"COMPARABLE_MILEAGE_UNAVAILABLE"
]
}
}
},
"else": {
"required": [
"mileageAdjustmentUnavailableReason"
],
"properties": {
"baseMarketAverage": false,
"mileageAdjustment": false,
"mileageAdjustedMarketAverage": false,
"mileageAdjustmentAvailable": {
"const": false
},
"mileageAdjustmentUnavailableReason": {
"const": "NO_VALUATION"
}
}
}
},
{
"if": {
"properties": {
"mileageAdjustmentAvailable": {
"const": true
}
}
},
"then": {
"required": [
"mileageAdjustment",
"mileageAdjustedMarketAverage"
],
"properties": {
"outcome": {
"const": "COMPLETE"
},
"mileageAdjustmentUnavailableReason": false
}
},
"else": {
"required": [
"mileageAdjustmentUnavailableReason"
],
"properties": {
"mileageAdjustment": false,
"mileageAdjustedMarketAverage": false
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "COMPLETE"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "NONE"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "INVALID_INPUT"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "ASK_USER"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "CLARIFICATION_REQUIRED"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "ASK_USER"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "INPUT_CONFLICT"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "ASK_USER"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "NO_MATCHES"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "REVIEW_INPUT"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "INSUFFICIENT_EVIDENCE"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "REVIEW_INPUT"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "PROVIDER_FAILURE"
}
}
},
"then": {
"properties": {
"retryable": {
"const": true
},
"nextAction": {
"properties": {
"type": {
"const": "RETRY_LATER"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "TIMEOUT"
}
}
},
"then": {
"properties": {
"retryable": {
"const": true
},
"nextAction": {
"properties": {
"type": {
"const": "RETRY_LATER"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "CANCELLED"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "STOP"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "DISABLED"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "USE_WEBSITE"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "DAILY_LIMIT"
}
}
},
"then": {
"properties": {
"retryable": {
"const": true
},
"nextAction": {
"properties": {
"type": {
"const": "WAIT_FOR_RESET"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "ATTEMPT_LIMIT"
}
}
},
"then": {
"properties": {
"retryable": {
"const": false
},
"nextAction": {
"properties": {
"type": {
"const": "REVIEW_INPUT"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "BUSY"
}
}
},
"then": {
"properties": {
"retryable": {
"const": true
},
"nextAction": {
"properties": {
"type": {
"const": "RETRY_LATER"
}
}
}
}
}
},
{
"if": {
"properties": {
"outcome": {
"const": "METER_UNAVAILABLE"
}
}
},
"then": {
"properties": {
"retryable": {
"const": true
},
"nextAction": {
"properties": {
"type": {
"const": "RETRY_LATER"
}
}
}
}
}
}
]
}Community
Evidence
Recent observations
verifiedversion not recorded1 tools
verifiedversion not recorded1 tools