OptiCat MCP AtlasContract · flow · evidence · ideas
System atlasVehicle discoveryget_vehicle_resources
Vehicle discovery · vehicle_to_part

Browse supplier application resources

Open supplier vehicle resources within the validated vehicle, category, brand and application scope.

Run the example Inspect contract
Visual model · record

Follow the implementation from request to evidence.

Every node corresponds to a real resolver, operation, validation boundary, or response surface in the current code.

Registered input contract

The exact arguments the MCP server accepts.

This schema is generated from the registered Python tool. Required fields, defaults, nested models, and constraints are not maintained by hand.

get_vehicle_resourcesArgumentsGenerated JSON Schema
read only
interactionInteractionContext | nulloptional
default null
requestVehicleResourcesInputrequired
base_vehicle_idinteger | nulloptional
default null
base_vehicle_region_idinteger | nulloptional
default null
brandsstring[]optional
makestring | nulloptional
default null
make_hintstring | nulloptional
default null
max_resultsintegeroptional
default 100min 1max 200
modelstring | nulloptional
default null
model_hintstring | nulloptional
default null
pageintegeroptional
default 1min 1
part_typestring | nulloptional
default null
qualifier_filtersobjectoptional
qualifiersQualifierSelection[]optional
typestringrequired

ACES attribute type name or API type token, such as EngineBaseId or PositionId

value_idinteger | stringrequired

ACES attribute value ID returned by a prior clarification

value_namestring | nulloptional

Optional readable label retained for answer assembly

default null
submodelstring | nulloptional
default null
yearintegerrequired
min 1886max 2100
year_abbreviatedbooleanoptional
default false
Example MCP argumentsMatches the existing demo handoff
{
  "request": {
    "year": 2020,
    "make": "Ford",
    "model": "Mustang",
    "part_type": "Windshield Wiper Blade"
  }
}
Show application resources for 2020 Ford Mustang wiper blades
Operation sequence

What each upstream call needs—and earns.

Conditional calls are labeled. Validation describes the exact rule that allows evidence to advance to the next stage.

01
getAutoCareVehicleResultsValidate the vehicle.
Requires
year · model
Produces
vehicle
Validation
Catalog resolves identity.
02
getAutoCareVehicleAssetsRetrieve application resources and summaries.
Requires
baseVehicleId
Produces
vehicle_assets · completeness
Validation
Zero facets do not prove absence; retain source scope.
Decision logic

Every important branch has a named outcome.

These are response decisions in the implemented service—not possible future behavior.

Qualifier unresolvedclarification_required

Do not silently broaden application scope.

Response anatomy

One shared schema, highlighted for this tool.

Bright fields are populated by this path. Dimmed fields remain part of CatalogResponse but are not a normal output of this tool.

Outcome1 active
statusResultStatusrequired
No nested fields. This value uses the type shown above.
summarystringrequired
No nested fields. This value uses the type shown above.
reason_codeReasonCode | null
No nested fields. This value uses the type shown above.
Context + completeness1 active
queryobject
No nested fields. This value uses the type shown above.
metadataobject
No nested fields. This value uses the type shown above.
completenessCompleteness
next_cursorstring | nulloptional
default null
next_pageinteger | nulloptional
default null
pages_fetchedintegeroptional
default 0
paging_modenone | page | cursor | capped | unknownoptional
default "none"5 allowed values
returnedintegeroptional
default 0
source_end_reachedbooleanoptional

This response reached the known end of the source query, even when earlier pages were returned separately.

default false
totalinteger | nulloptional
default null
truncatedbooleanoptional
default false
Domain evidence1 active
vehiclesVehicleIdentity[]
No nested fields. This value uses the type shown above.
partsPartRecord[]
No nested fields. This value uses the type shown above.
relationshipsRelationshipRecord[]
No nested fields. This value uses the type shown above.
relationship_outcomeRelationshipOutcome | null
No nested fields. This value uses the type shown above.
fitmentFitmentDecision | null
No nested fields. This value uses the type shown above.
interchange_validationsInterchangeValidation[]
No nested fields. This value uses the type shown above.
Conversation controls0 active
clarificationClarification | null
No nested fields. This value uses the type shown above.
pending_clarificationsClarification[]

Every open clarification dimension in one round (clarification stays = the first). Ask them together instead of one round trip per dimension.

No nested fields. This value uses the type shown above.
warningsstring[]
No nested fields. This value uses the type shown above.
Observability1 active
errorCatalogError | null
No nested fields. This value uses the type shown above.
evidenceEvidenceRecord[]
No nested fields. This value uses the type shown above.
What reaches the answerPreserved output families
SupplierResource nameApplication summariesOriginal URLsResource typeCoverage
Grounding guaranteesRules against invented certainty
  • No product-photo substitution
  • No inferred hotspots
  • No fitment claim
Implementation sourcesSymbols behind the visual
Handlerget_vehicle_resourcespoc/opticat-mcp-v2/src/opticat_mcp_v2/vehicle_resources.py
Registrationget_vehicle_resourcespoc/opticat-mcp-v2/src/opticat_mcp_v2/server.py
Web routingmcpToolForPlanlib/mcp.ts
Boundaries and ideas

What is known, and what could become possible.

Current gaps stay separate from product concepts so the visual never implies that an idea has already shipped.

Known gapsVerified limitations in the current path
  1. 01

    Supplier asset availability and entitlement require a live run

Explore
Verified diagram mapping

Use diagram-to-part navigation only with supplier mapping data.

Product concept · not implemented