SkoIA Parts
Resolve part problems, check compatibility and identify only the information still missing.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- LOWget_next_observation에서
- LOWget_product에서
- LOWget_compatibility에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"skoia-parts": {
"url": "https://parts.skoia.me/mcp"
}
}
}원격 엔드포인트
https://parts.skoia.me/mcpstreamable-http할 수 있는 일
도구 목록
도구 (15)
🟢understand_physical_problem(description)
Builds the canonical PhysicalProblem, Observation Graph and explicit unknown set from the supplied description.
입력 스키마
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_next_observation(description)
Returns the single highest-value missing observation without promoting hypotheses to facts.
입력 스키마
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢generate_hypotheses(description)
Explores candidate transformations from the same PhysicalProblem and labels every unverified candidate as HYPOTHESIS.
입력 스키마
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢search_candidates(query, limit)
Searches the verified local index for candidates; a candidate is never presented as an identified product without evidence.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢synthesize_physical_solution(description)
Runs the canonical resolver and returns either a supported solution or the next required observation.
입력 스키마
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢verify_solution(description, candidate)
Checks a proposed candidate independently against the canonical constraints and reports verification separately from generation.
입력 스키마
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"candidate": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"description",
"candidate"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢generate_artifact(solutionId, format, entitlement)
Generates only LIVE deterministic formats after plan acceptance and verification; STEP remains unavailable.
입력 스키마
{
"type": "object",
"properties": {
"solutionId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"format": {
"type": "string",
"enum": [
"STL",
"3MF",
"OPENSCAD"
]
},
"entitlement": {
"type": "string",
"enum": [
"FREE",
"PAID_VERIFIED"
],
"default": "FREE"
}
},
"required": [
"solutionId",
"format"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_verified_commerce_options(query, limit, surface)
Returns discovery candidates separately from RevenueGuard-approved monetizable offers and enforces distribution rights per surface.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 6
},
"surface": {
"type": "string",
"enum": [
"WEB",
"REST_API",
"MCP",
"WEBMCP",
"CHATGPT_APP",
"APIFY"
],
"default": "MCP"
}
},
"required": [
"query"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢search_parts(query, limit)
Searches the verified local product and part-type index without inventing identities.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢resolve_problem(description, intent, productA, productB, relationship)
Runs the deterministic problem-first resolver and returns the best supported next action or the minimum missing information.
입력 스키마
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"intent": {
"type": "string",
"enum": [
"CONNECT",
"REPAIR",
"FIND_OR_MAKE",
"MODIFY",
"CREATE"
]
},
"productA": {
"type": "string",
"maxLength": 200
},
"productB": {
"type": "string",
"maxLength": 200
},
"relationship": {
"type": "string",
"maxLength": 80
}
},
"required": [
"description"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_product(id)
Returns one canonical ProductTwin and its source-level provenance by stable identifier.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
}
},
"required": [
"id"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_compatibility(productA, productB)
Compares two canonical ProductTwins. It reports direct compatibility only when their verified interface system matches.
입력 스키마
{
"type": "object",
"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}$"
}
},
"required": [
"productA",
"productB"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_fit_guidance(nominalMm, fitType, measurementBasis, gender, material, ...)
Calculates deterministic manufacturing compensation and returns an explicit physical-test warning.
입력 스키마
{
"type": "object",
"properties": {
"nominalMm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"fitType": {
"type": "string",
"enum": [
"PRESS",
"TIGHT",
"SLIDING",
"LOOSE"
]
},
"measurementBasis": {
"type": "string",
"enum": [
"NOMINAL",
"INTERNAL",
"EXTERNAL"
]
},
"gender": {
"type": "string",
"enum": [
"MALE",
"FEMALE",
"NEUTRAL"
]
},
"material": {
"type": "string",
"maxLength": 20
},
"process": {
"type": "string",
"maxLength": 30
},
"userCalibrationMm": {
"type": "number",
"minimum": -5,
"maximum": 5
}
},
"required": [
"nominalMm",
"fitType"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢list_generation_options(intent)
Lists only generator families implemented by the current deterministic core.
입력 스키마
{
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"CONNECT",
"REPAIR",
"CREATE"
]
}
},
"required": [],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_offers(query, limit)
Deprecated compatibility adapter. Returns provider discovery only; use get_verified_commerce_options for separated verified output.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 6
}
},
"required": [
"query"
],
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"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"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}커뮤니티
증거