Skip to content

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.

Changes · 6

15 tools: 6 change things and 9 only read.

Scanned Oct 21, 2026

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/mcp

Findings

Matches of fixed checks, with the text they matched.

4 warn
  • The server marks "generate_hypotheses" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_hypotheses" says "generate": a word for a change.

    What this check looks for
  • The server marks "synthesize_physical_solution" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "run": a word for a change.

    What this check looks for
  • The server marks "generate_artifact" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_artifact" says "generate": a word for a change.

    What this check looks for
  • The server marks "resolve_problem" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "resolve_problem" says "resolve": a word for reading.

    What this check looks for

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".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_artifact" says "generate": a word for a change.

      What this check looks for
    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".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "generate_hypotheses" says "generate": a word for a change.

      What this check looks for
    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".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "resolve_problem" says "resolve": a word for reading.

      What this check looks for
    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".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The description's first verb is "run": a word for a change.

      What this check looks for
    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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.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.