SkoIA Parts
by macacoengenhocas · remote · no sign-in to list tools · v0.34.1 · published by GitHub user macacoengenhocas
Resolve part problems, check compatibility and identify only the information still missing.
15 tools: 6 change things and 9 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things6Claude Code: ask: see these tools
- Only reads9Claude Code: allow: see these tools
4 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http skoia-parts https://parts.skoia.me/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "generate_hypotheses" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_hypotheses" says "generate": a word for a change.
The server marks "synthesize_physical_solution" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "run": a word for a change.
The server marks "generate_artifact" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_artifact" says "generate": a word for a change.
- Warnresolve_problem
The server marks "resolve_problem" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "resolve_problem" says "resolve": a word for reading.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
15 tools
Changes things 6Claude Code: ask
generate_artifactGenerates only LIVE deterministic formats after plan acceptance and verification; STEP remains unavailable.1 finding
Why it is in this group
- The name "generate_artifact" says "generate": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "generate_artifact" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_artifact" says "generate": a word for a change.
Description, as the server wrote it Generates only LIVE deterministic formats after plan acceptance and verification; STEP remains unavailable.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
generate_hypothesesExplores candidate transformations from the same PhysicalProblem and labels every unverified candidate as HYPOTHESIS.1 finding
Why it is in this group
- The name "generate_hypotheses" says "generate": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "generate_hypotheses" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_hypotheses" says "generate": a word for a change.
Description, as the server wrote it Explores candidate transformations from the same PhysicalProblem and labels every unverified candidate as HYPOTHESIS.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
resolve_problemRuns the deterministic problem-first resolver and returns the best supported next action or the minimum missing information.1 finding
Why it is in this group
- The name "resolve_problem" says "resolve": a word for reading.
- The description's first verb is "run": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "resolve_problem" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "resolve_problem" says "resolve": a word for reading.
Description, as the server wrote it Runs the deterministic problem-first resolver and returns the best supported next action or the minimum missing information.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
synthesize_physical_solutionRuns the canonical resolver and returns either a supported solution or the next required observation.1 finding
Why it is in this group
- The description's first verb is "run": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "synthesize_physical_solution" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "run": a word for a change.
Description, as the server wrote it Runs the canonical resolver and returns either a supported solution or the next required observation.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
understand_physical_problemBuilds the canonical PhysicalProblem, Observation Graph and explicit unknown set from the supplied description.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Builds the canonical PhysicalProblem, Observation Graph and explicit unknown set from the supplied description.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
verify_solutionChecks a proposed candidate independently against the canonical constraints and reports verification separately from generation.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Checks a proposed candidate independently against the canonical constraints and reports verification separately from generation.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
Only reads 9Claude Code: allow
get_compatibilityCompares two canonical ProductTwins.No findings
Why it is in this group
- The name "get_compatibility" says "get": a word for reading.
Description, as the server wrote it Compares two canonical ProductTwins. It reports direct compatibility only when their verified interface system matches.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_fit_guidanceCalculates deterministic manufacturing compensation and returns an explicit physical-test warning.No findings
Why it is in this group
- The name "get_fit_guidance" says "get": a word for reading.
Description, as the server wrote it Calculates deterministic manufacturing compensation and returns an explicit physical-test warning.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_next_observationReturns the single highest-value missing observation without promoting hypotheses to facts.No findings
Why it is in this group
- The name "get_next_observation" says "get": a word for reading.
Description, as the server wrote it Returns the single highest-value missing observation without promoting hypotheses to facts.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_offersDeprecated compatibility adapter.No findings
Why it is in this group
- The name "get_offers" says "get": a word for reading.
Description, as the server wrote it Deprecated compatibility adapter. Returns provider discovery only; use get_verified_commerce_options for separated verified output.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_productReturns one canonical ProductTwin and its source-level provenance by stable identifier.No findings
Why it is in this group
- The name "get_product" says "get": a word for reading.
Description, as the server wrote it Returns one canonical ProductTwin and its source-level provenance by stable identifier.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_verified_commerce_optionsReturns discovery candidates separately from RevenueGuard-approved monetizable offers and enforces distribution rights per surface.No findings
Why it is in this group
- The name "get_verified_commerce_options" says "get": a word for reading.
Description, as the server wrote it Returns discovery candidates separately from RevenueGuard-approved monetizable offers and enforces distribution rights per surface.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
list_generation_optionsLists only generator families implemented by the current deterministic core.No findings
Why it is in this group
- The name "list_generation_options" says "list": a word for reading.
Description, as the server wrote it Lists only generator families implemented by the current deterministic core.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_candidatesSearches the verified local index for candidates; a candidate is never presented as an identified product without evidence.No findings
Why it is in this group
- The name "search_candidates" says "search": a word for reading.
Description, as the server wrote it Searches the verified local index for candidates; a candidate is never presented as an identified product without evidence.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_partsSearches the verified local product and part-type index without inventing identities.No findings
Why it is in this group
- The name "search_parts" says "search": a word for reading.
Description, as the server wrote it Searches the verified local product and part-type index without inventing identities.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.34.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http skoia-parts https://parts.skoia.me/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__skoia-parts__get_next_observation",
"mcp__skoia-parts__search_candidates",
"mcp__skoia-parts__get_verified_commerce_options",
"mcp__skoia-parts__search_parts",
"mcp__skoia-parts__get_product",
"mcp__skoia-parts__get_compatibility",
"mcp__skoia-parts__get_fit_guidance",
"mcp__skoia-parts__list_generation_options",
"mcp__skoia-parts__get_offers"
],
"ask": [
"mcp__skoia-parts__understand_physical_problem",
"mcp__skoia-parts__generate_hypotheses",
"mcp__skoia-parts__synthesize_physical_solution",
"mcp__skoia-parts__verify_solution",
"mcp__skoia-parts__generate_artifact",
"mcp__skoia-parts__resolve_problem"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as skoia-parts. Review it before you use it.
