Consumer Vehicle Reviews (by Make, Model & Year)
omnial/get-vehicle-reviews
Given a vehicle make, model, and model year, returns consumer-submitted Carfax reviews for that exact combination: individual reviews with star rating, title, free-text comments, and a per-category breakdown (Exterior, Interior, Performance, Family, Cost), plus aggregate statistics -- total review count, average rating, and the distribution of reviews by star count. A make/model/year combination with no reviews on file returns zeroed aggregate stats and an empty review list rather than an error.
activeper callv2
Price
Up to $0.0137 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/get-vehicle-reviews" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/get-vehicle-reviews" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/get-vehicle-reviews", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/get-vehicle-reviews", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0137 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"year",
"model",
"make"
],
"properties": {
"make": {
"type": "string",
"description": "Vehicle make (e.g. Toyota, Honda, Ford)."
},
"year": {
"type": "string",
"description": "Vehicle model year as a 4-digit string (e.g. 2023)."
},
"model": {
"type": "string",
"description": "Vehicle model (e.g. Camry, Civic, F-150). Must correspond to the specified make."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"modelYears": {
"type": "object",
"description": "Exactly one key present per call: the queried `year` input, verbatim (e.g. '2023'). Not a fixed set of properties -- the key name varies with the call's own input.",
"additionalProperties": {
"type": "object",
"properties": {
"reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The review's own id."
},
"title": {
"type": "string"
},
"rating": {
"type": "number",
"description": "1-5 star rating."
},
"status": {
"type": "string",
"description": "The review's moderation status, e.g. 'ACCEPTED_MAKE_MODEL_YEAR'."
},
"helpful": {
"type": "object",
"properties": {
"helpfulCount": {
"type": "number"
}
},
"additionalProperties": true
},
"vehicle": {
"type": "object",
"properties": {
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"modelYear": {
"type": "number"
}
},
"additionalProperties": true
},
"comments": {
"type": "string",
"description": "The reviewer's free-text comments."
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "A review category, e.g. 'Cost', 'Exterior', 'Performance', 'Family', 'Interior'."
},
"rating": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Per-category star ratings the reviewer gave, when provided."
},
"changedOn": {
"type": "string",
"description": "ISO 8601 timestamp the review was last moderated/updated."
},
"createdOn": {
"type": "string",
"description": "ISO 8601 timestamp the review was submitted."
},
"updatedBy": {
"type": "string",
"description": "The moderator or moderation-system label that last touched this review, e.g. 'Marvin (the Moderator)'. Not a per-reviewer identity: the same label typically appears on every review, identifying the shared moderation process rather than any individual person."
},
"screenName": {
"type": "string",
"description": "The reviewer's own publicly displayed name or handle, exactly as it appears on the published review -- observed values range from clear pseudonyms ('CamryGirl') to what read as a reviewer's real name ('Roxanne Davis'), since this is whatever the reviewer chose to submit with their public review."
}
},
"additionalProperties": true
},
"description": "Individual reviews for this exact make/model/year. Empty when none are on file."
},
"totalReviews": {
"type": "number",
"description": "Review count for this exact make/model/year. 0 when none are on file."
},
"averageRating": {
"type": "number",
"description": "Average star rating for this exact make/model/year. 0 when none are on file."
},
"totalsByRating": {
"type": "object",
"properties": {
"1": {
"type": "number"
},
"2": {
"type": "number"
},
"3": {
"type": "number"
},
"4": {
"type": "number"
},
"5": {
"type": "number"
}
},
"description": "Review counts keyed '1' through '5' (star rating).",
"additionalProperties": true
},
"percentageByRating": {
"type": "object",
"properties": {
"1": {
"type": "number"
},
"2": {
"type": "number"
},
"3": {
"type": "number"
},
"4": {
"type": "number"
},
"5": {
"type": "number"
}
},
"description": "Percent of reviews at each star rating, keyed '1' through '5'.",
"additionalProperties": true
},
"averageRatingByCategory": {
"type": "object",
"description": "Average rating per review category, e.g. 'Cost', 'Exterior', 'Family', 'Interior', 'Performance'. All zero when no reviews exist.",
"additionalProperties": {
"type": "number"
}
}
},
"additionalProperties": true
}
},
"overallTotalReviews": {
"type": "number",
"description": "Total review count across ALL model years of this make/model, not just the queried year. 0 when no reviews exist for any year."
},
"overallAverageRating": {
"type": "number",
"description": "Average star rating across ALL model years of this make/model, not just the queried year. 0 when no reviews exist for any year."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real calls observed."
}
},
"description": "The vehicle-reviews result.",
"additionalProperties": true
}