Servidor MCP

SkoIA Parts

io.github.macacoengenhocas/skoia-parts
Comercio y retail Ciencia e ingeniería Público y accesible MCP 2026-07-28

Qué hace este MCP

Resolves physical-part identification and compatibility problems, tracks evidence and missing observations, verifies proposed solutions, and provides selected commerce options.

generate_artifact
Generate a verified artifact
Generates only LIVE deterministic formats after plan acceptance and verification; STEP remains unavailable.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['solutionId', 'format'], 'properties': {'format': {'enum': ['STL', '3MF', 'OPENSCAD'], 'type': 'string'}, 'solutionId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'entitlement': {'enum': ['FREE', 'PAID_VERIFIED'], 'type': 'string', 'default': 'FREE'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
generate_hypotheses
Generate physical hypotheses
Explores candidate transformations from the same PhysicalProblem and labels every unverified candidate as HYPOTHESIS.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['description'], 'properties': {'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
get_compatibility
Inspect compatibility evidence
Compares two canonical ProductTwins. It reports direct compatibility only when their verified interface system matches.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['productA', 'productB'], 'properties': {'productA': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'productB': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
get_fit_guidance
Calculate fit guidance
Calculates deterministic manufacturing compensation and returns an explicit physical-test warning.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['nominalMm', 'fitType'], 'properties': {'gender': {'enum': ['MALE', 'FEMALE', 'NEUTRAL'], 'type': 'string'}, 'fitType': {'enum': ['PRESS', 'TIGHT', 'SLIDING', 'LOOSE'], 'type': 'string'}, 'process': {'type': 'string', 'maxLength': 30}, 'material': {'type': 'string', 'maxLength': 20}, 'nominalMm': {'type': 'number', 'maximum': 1000, 'exclusiveMinimum': 0}, 'measurementBasis': {'enum': ['NOMINAL', 'INTERNAL', 'EXTERNAL'], 'type': 'string'}, 'userCalibrationMm': {'type': 'number', 'maximum': 5, 'minimum': -5}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
get_next_observation
Get the next observation
Returns the single highest-value missing observation without promoting hypotheses to facts.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['description'], 'properties': {'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
get_offers
Get commerce discovery candidates
Deprecated compatibility adapter. Returns provider discovery only; use get_verified_commerce_options for separated verified output.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 6, 'maximum': 10, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 300, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
get_product
Get a ProductTwin
Returns one canonical ProductTwin and its source-level provenance by stable identifier.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
get_verified_commerce_options
Get verified commerce options
Returns discovery candidates separately from RevenueGuard-approved monetizable offers and enforces distribution rights per surface.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 6, 'maximum': 10, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'surface': {'enum': ['WEB', 'REST_API', 'MCP', 'WEBMCP', 'CHATGPT_APP', 'APIFY'], 'type': 'string', 'default': 'MCP'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
list_generation_options
List generation options
Lists only generator families implemented by the current deterministic core.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'intent': {'enum': ['CONNECT', 'REPAIR', 'CREATE'], 'type': 'string'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
resolve_problem
Resolve a physical-part problem
Runs the deterministic problem-first resolver and returns the best supported next action or the minimum missing information.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['description'], 'properties': {'intent': {'enum': ['CONNECT', 'REPAIR', 'FIND_OR_MAKE', 'MODIFY', 'CREATE'], 'type': 'string'}, 'productA': {'type': 'string', 'maxLength': 200}, 'productB': {'type': 'string', 'maxLength': 200}, 'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'relationship': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
search_candidates
Search candidate parts
Searches the verified local index for candidates; a candidate is never presented as an identified product without evidence.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 8, 'maximum': 20, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 500, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
search_parts
Search physical parts
Searches the verified local product and part-type index without inventing identities.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 8, 'maximum': 20, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 500, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
synthesize_physical_solution
Synthesize a physical solution
Runs the canonical resolver and returns either a supported solution or the next required observation.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['description'], 'properties': {'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
understand_physical_problem
Understand a physical problem
Builds the canonical PhysicalProblem, Observation Graph and explicit unknown set from the supplied description.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['description'], 'properties': {'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
verify_solution
Verify a proposed solution
Checks a proposed candidate independently against the canonical constraints and reports verification separately from generation.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['description', 'candidate'], 'properties': {'candidate': {'type': 'object', 'additionalProperties': True}, 'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['schemaVersion', 'tool', 'requestId', 'status', 'facts', 'confidence', 'provenance', 'warnings', 'data'], 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'tool': {'type': 'string'}, 'facts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'maxItems': 200}, 'status': {'enum': ['OK', 'NEEDS_INPUT', 'BLOCKED', 'UNAVAILABLE'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 30}, 'requestId': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9_.:-]{1,119}$'}, 'confidence': {'type': 'object', 'required': ['score', 'level'], 'properties': {'level': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'UNKNOWN'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'reason': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provenance': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 500}, {'type': 'null'}]}, 'retrieved_at': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}]}, 'verification_status': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 30}, 'schemaVersion': {'const': 1}}, 'additionalProperties': False}
Añadido
get_offers
17 de September de 2026 a las 12:43
Añadido
list_generation_options
17 de September de 2026 a las 12:43
Añadido
get_fit_guidance
17 de September de 2026 a las 12:43
Añadido
get_compatibility
17 de September de 2026 a las 12:43
Añadido
get_product
17 de September de 2026 a las 12:43
Añadido
resolve_problem
17 de September de 2026 a las 12:43
Añadido
search_parts
17 de September de 2026 a las 12:43
Añadido
get_verified_commerce_options
17 de September de 2026 a las 12:43
Añadido
generate_artifact
17 de September de 2026 a las 12:43
Añadido
verify_solution
17 de September de 2026 a las 12:43
Añadido
synthesize_physical_solution
17 de September de 2026 a las 12:43
Añadido
search_candidates
17 de September de 2026 a las 12:43
Añadido
generate_hypotheses
17 de September de 2026 a las 12:43
Añadido
get_next_observation
17 de September de 2026 a las 12:43
Añadido
understand_physical_problem
17 de September de 2026 a las 12:43