Punchneedle.ai

Make punch needle patterns from images, browse patterns, estimate yarn, resize and match materials.

Should I use this

Quality & Safety

A
Description quality
84%
Schema completeness
91%
Naming quality
94%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (3)

  • LOWTool 'get_pattern' description lacks action verbin get_pattern
  • LOWTool 'resize_pattern' description lacks action verbin resize_pattern
  • LOWTool 'get_material_guide' description lacks action verbin get_material_guide

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~5,995Tokens (tool definitions)
~9.4 KBTypical response size
Significant attention impact (4.68% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "punchneedle-ai": {
      "url": "https://punchneedle.ai/api/mcp"
    }
  }
}

Remote endpoints

https://punchneedle.ai/api/mcpstreamable-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢make_pattern_from_image(image_url, imageUrl, url, image, width, ...)

Converts a public PNG, JPEG or WebP image into a punch needle pattern with the website's pattern converter. Returns the pattern as a stitch grid preview, its colours and the yarn each colour needs in a fine-wool kit and a rug-wool kit.

Input Schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "description": "Public web address (https) of a PNG, JPEG or WebP image of at most 4 MB.",
      "minLength": 1,
      "maxLength": 2048
    },
    "imageUrl": {
      "type": "string",
      "description": "Same value as image_url.",
      "minLength": 1,
      "maxLength": 2048
    },
    "url": {
      "type": "string",
      "description": "Same value as image_url.",
      "minLength": 1,
      "maxLength": 2048
    },
    "image": {
      "type": "string",
      "description": "Same value as image_url.",
      "minLength": 1,
      "maxLength": 2048
    },
    "width": {
      "type": "number",
      "description": "Finished width of the pattern in the chosen unit: 20 to 2000 mm, 2 to 200 cm or 0.8 to 78.7 in. The default is 20 cm.",
      "minimum": 0.7,
      "maximum": 2000
    },
    "size": {
      "type": "number",
      "description": "Same value as width.",
      "minimum": 0.7,
      "maximum": 2000
    },
    "unit": {
      "type": "string",
      "enum": [
        "mm",
        "cm",
        "in"
      ],
      "description": "Unit of the width; the default is cm."
    },
    "colours": {
      "type": "integer",
      "minimum": 2,
      "maximum": 32,
      "description": "Largest number of yarn colours in the pattern, from 2 to 32. The default is 6."
    },
    "colors": {
      "type": "integer",
      "minimum": 2,
      "maximum": 32,
      "description": "Same value as colours."
    }
  },
  "required": [],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "item": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description",
        "category",
        "url",
        "facts",
        "links",
        "preview",
        "kits"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "eyebrow": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "facts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "url"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "tables": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "columns",
              "rows"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "swatches": {
                "type": "array",
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "note": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "text"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "check": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "blocks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "heading"
            ],
            "properties": {
              "heading": {
                "type": "string"
              },
              "paragraphs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "preview": {
          "type": "object",
          "required": [
            "columns",
            "rows",
            "palette",
            "runs"
          ],
          "properties": {
            "columns": {
              "type": "integer"
            },
            "rows": {
              "type": "integer"
            },
            "palette": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "runs": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "additionalProperties": false
        },
        "kits": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "setup",
              "name",
              "totalMetres",
              "wholeSkeins",
              "rows"
            ],
            "properties": {
              "setup": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "yarn": {
                "type": "string"
              },
              "needles": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "loopHeightsMm": {
                "type": "array",
                "items": {
                  "type": "number"
                }
              },
              "extraPercent": {
                "type": "number"
              },
              "areaCm2": {
                "type": "number"
              },
              "totalMetres": {
                "type": "number"
              },
              "totalGrams": {
                "type": "number"
              },
              "wholeSkeins": {
                "type": "integer"
              },
              "skeinMetres": {
                "type": "number"
              },
              "skeinGrams": {
                "type": "number"
              },
              "holderMm": {
                "type": "number"
              },
              "clothMm": {
                "type": "number"
              },
              "basis": {
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "letters",
                    "name",
                    "hex",
                    "metres",
                    "grams",
                    "skeins"
                  ],
                  "properties": {
                    "letters": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "hex": {
                      "type": "string"
                    },
                    "metres": {
                      "type": "number"
                    },
                    "grams": {
                      "type": "number"
                    },
                    "skeins": {
                      "type": "integer"
                    },
                    "parts": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": true
    }
  },
  "required": [
    "view",
    "item"
  ],
  "additionalProperties": true
}
🟢find_patterns(theme, category, collection, query, level, ...)

Lists the original punch needle patterns in the Punchneedle.ai library, filtered by theme and level. Each pattern shows its finished size, number of colours, level and preview image.

Input Schema

{
  "type": "object",
  "properties": {
    "theme": {
      "type": "string",
      "description": "Theme or collection such as flowers, animals, geometric, Christmas, Halloween, hearts, landscapes, rainbows, food or primitive, or a word from a pattern's name.",
      "minLength": 1,
      "maxLength": 80
    },
    "category": {
      "type": "string",
      "description": "Same value as theme.",
      "minLength": 1,
      "maxLength": 80
    },
    "collection": {
      "type": "string",
      "description": "Same value as theme.",
      "minLength": 1,
      "maxLength": 80
    },
    "query": {
      "type": "string",
      "description": "Same value as theme.",
      "minLength": 1,
      "maxLength": 80
    },
    "level": {
      "type": "string",
      "description": "Level of the patterns: beginner for the website's beginner collection, or any for all patterns.",
      "minLength": 1,
      "maxLength": 40
    },
    "difficulty": {
      "type": "string",
      "description": "Same value as level.",
      "minLength": 1,
      "maxLength": 40
    }
  },
  "required": [],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "catalog"
      ]
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "description",
          "category",
          "url"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "widthMm": {
            "type": "number"
          },
          "heightMm": {
            "type": "number"
          },
          "colourCount": {
            "type": "integer"
          },
          "level": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "image": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "total": {
      "type": "integer"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "pageSize": {
      "type": "integer"
    },
    "request": {
      "type": "object"
    },
    "title": {
      "type": "string"
    },
    "subtitle": {
      "type": "string"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "links": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "url"
        ],
        "properties": {
          "label": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "required": [
    "view",
    "items",
    "total",
    "nextCursor",
    "pageSize",
    "request"
  ],
  "additionalProperties": true
}
🟢get_pattern(pattern, id, name, slug)

Returns one library pattern with its size, colours, making steps, materials and the yarn each colour needs in a fine-wool kit and a rug-wool kit.

Input Schema

{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Pattern id such as cat or sunflower, the pattern's name, or its page address on Punchneedle.ai.",
      "minLength": 1,
      "maxLength": 120
    },
    "id": {
      "type": "string",
      "description": "Same value as pattern.",
      "minLength": 1,
      "maxLength": 120
    },
    "name": {
      "type": "string",
      "description": "Same value as pattern.",
      "minLength": 1,
      "maxLength": 120
    },
    "slug": {
      "type": "string",
      "description": "Same value as pattern.",
      "minLength": 1,
      "maxLength": 120
    }
  },
  "required": [],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "item": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description",
        "category",
        "url",
        "facts",
        "links",
        "image",
        "steps",
        "materials",
        "kits"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "eyebrow": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "facts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "url"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "tables": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "columns",
              "rows"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "swatches": {
                "type": "array",
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "note": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "text"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "check": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "blocks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "heading"
            ],
            "properties": {
              "heading": {
                "type": "string"
              },
              "paragraphs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "materials": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "kits": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "setup",
              "name",
              "totalMetres",
              "wholeSkeins",
              "rows"
            ],
            "properties": {
              "setup": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "yarn": {
                "type": "string"
              },
              "needles": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "loopHeightsMm": {
                "type": "array",
                "items": {
                  "type": "number"
                }
              },
              "extraPercent": {
                "type": "number"
              },
              "areaCm2": {
                "type": "number"
              },
              "totalMetres": {
                "type": "number"
              },
              "totalGrams": {
                "type": "number"
              },
              "wholeSkeins": {
                "type": "integer"
              },
              "skeinMetres": {
                "type": "number"
              },
              "skeinGrams": {
                "type": "number"
              },
              "holderMm": {
                "type": "number"
              },
              "clothMm": {
                "type": "number"
              },
              "basis": {
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "letters",
                    "name",
                    "hex",
                    "metres",
                    "grams",
                    "skeins"
                  ],
                  "properties": {
                    "letters": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "hex": {
                      "type": "string"
                    },
                    "metres": {
                      "type": "number"
                    },
                    "grams": {
                      "type": "number"
                    },
                    "skeins": {
                      "type": "integer"
                    },
                    "parts": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": true
    }
  },
  "required": [
    "view",
    "item"
  ],
  "additionalProperties": true
}
🟢calculate_yarn(width, height, shape, unit, colours, ...)

Estimates the yarn for a punch needle design from its size, the share of each colour and the needle and loop height, or from a measured swatch. Returns metres, grams and whole skeins for each colour.

Input Schema

{
  "type": "object",
  "properties": {
    "width": {
      "type": "number",
      "description": "Width of the design, or the diameter of a circle, in the chosen unit.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "height": {
      "type": "number",
      "description": "Height of a rectangular design in the chosen unit; a circle needs none.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "shape": {
      "type": "string",
      "enum": [
        "rectangle",
        "circle"
      ],
      "description": "Shape of the design; the default is rectangle."
    },
    "unit": {
      "type": "string",
      "enum": [
        "mm",
        "cm",
        "in"
      ],
      "description": "Unit of the width and height; the default is cm."
    },
    "colours": {
      "type": "array",
      "minItems": 1,
      "maxItems": 32,
      "description": "Colours with their share of the design area in percent; the shares add up to 100. A single colour at 100 percent is the default.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the colour.",
            "minLength": 0,
            "maxLength": 40
          },
          "percent": {
            "type": "number",
            "description": "Share of the design area in percent.",
            "minimum": 0.001,
            "maximum": 100
          },
          "share": {
            "type": "number",
            "description": "Same value as percent.",
            "minimum": 0.001,
            "maximum": 100
          }
        },
        "required": [],
        "additionalProperties": false
      }
    },
    "colors": {
      "type": "array",
      "minItems": 1,
      "maxItems": 32,
      "description": "Same value as colours.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the colour.",
            "minLength": 0,
            "maxLength": 40
          },
          "percent": {
            "type": "number",
            "description": "Share of the design area in percent.",
            "minimum": 0.001,
            "maximum": 100
          },
          "share": {
            "type": "number",
            "description": "Same value as percent.",
            "minimum": 0.001,
            "maximum": 100
          }
        },
        "required": [],
        "additionalProperties": false
      }
    },
    "needle": {
      "type": "string",
      "description": "Oxford needle such as #14 fine, #13 fine, #10 fine, #10 regular, #9 regular or #8 regular. The default is #14 fine.",
      "minLength": 1,
      "maxLength": 40
    },
    "loop_height_mm": {
      "type": "number",
      "description": "Loop height in mm: 3.2, 4.8, 6.4, 9.5 or 12.7.",
      "minimum": 0.1,
      "maximum": 50
    },
    "extra_percent": {
      "type": "number",
      "description": "Extra yarn for tails and finishing in percent, from 0 to 100. The default is 15.",
      "minimum": 0,
      "maximum": 100
    },
    "buffer": {
      "type": "number",
      "description": "Same value as extra_percent.",
      "minimum": 0,
      "maximum": 100
    },
    "swatch_width_cm": {
      "type": "number",
      "description": "Width in cm of a measured filled swatch; the four swatch values come together.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "swatch_height_cm": {
      "type": "number",
      "description": "Height in cm of the measured swatch.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "swatch_yarn_m": {
      "type": "number",
      "description": "Metres of yarn used in the measured swatch.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "skein_length_m": {
      "type": "number",
      "description": "Length in metres of one skein of the project yarn.",
      "minimum": 0.001,
      "maximum": 100000
    }
  },
  "required": [],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "item": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description",
        "category",
        "url",
        "facts",
        "links",
        "tables"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "eyebrow": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "facts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "url"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "tables": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "columns",
              "rows"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "swatches": {
                "type": "array",
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "note": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "text"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "check": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "blocks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "heading"
            ],
            "properties": {
              "heading": {
                "type": "string"
              },
              "paragraphs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true
    }
  },
  "required": [
    "view",
    "item"
  ],
  "additionalProperties": true
}
🟢resize_pattern(pattern, id, width, height, unit, ...)

Rescales a library pattern, or a design of a given size, to a new width or height with the proportions kept. Returns the new dimensions, the number of printed A4 and US Letter sheets and, for a library pattern, the yarn at the new size.

Input Schema

{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Library pattern id such as cat or sunflower, or its name.",
      "minLength": 1,
      "maxLength": 120
    },
    "id": {
      "type": "string",
      "description": "Same value as pattern.",
      "minLength": 1,
      "maxLength": 120
    },
    "width": {
      "type": "number",
      "description": "Current width of a design that is not a library pattern, in the chosen unit.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "height": {
      "type": "number",
      "description": "Current height of a design that is not a library pattern, in the chosen unit.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "unit": {
      "type": "string",
      "enum": [
        "mm",
        "cm",
        "in"
      ],
      "description": "Unit of the sizes; the default is cm."
    },
    "new_width": {
      "type": "number",
      "description": "New width in the chosen unit, from 10 mm to 2000 mm. The height follows the proportions.",
      "minimum": 0.001,
      "maximum": 100000
    },
    "new_height": {
      "type": "number",
      "description": "New height in the chosen unit, up to 2000 mm. The width follows the proportions.",
      "minimum": 0.001,
      "maximum": 100000
    }
  },
  "required": [],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "item": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description",
        "category",
        "url",
        "facts",
        "links",
        "scale",
        "newWidthMm",
        "newHeightMm",
        "sheets"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "eyebrow": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "facts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "url"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "tables": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "columns",
              "rows"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "swatches": {
                "type": "array",
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "note": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "text"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "check": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "blocks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "heading"
            ],
            "properties": {
              "heading": {
                "type": "string"
              },
              "paragraphs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "scale": {
          "type": "number"
        },
        "newWidthMm": {
          "type": "number"
        },
        "newHeightMm": {
          "type": "number"
        },
        "sheets": {
          "type": "object"
        },
        "kits": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "setup",
              "name",
              "totalMetres",
              "wholeSkeins",
              "rows"
            ],
            "properties": {
              "setup": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "yarn": {
                "type": "string"
              },
              "needles": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "loopHeightsMm": {
                "type": "array",
                "items": {
                  "type": "number"
                }
              },
              "extraPercent": {
                "type": "number"
              },
              "areaCm2": {
                "type": "number"
              },
              "totalMetres": {
                "type": "number"
              },
              "totalGrams": {
                "type": "number"
              },
              "wholeSkeins": {
                "type": "integer"
              },
              "skeinMetres": {
                "type": "number"
              },
              "skeinGrams": {
                "type": "number"
              },
              "holderMm": {
                "type": "number"
              },
              "clothMm": {
                "type": "number"
              },
              "basis": {
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "letters",
                    "name",
                    "hex",
                    "metres",
                    "grams",
                    "skeins"
                  ],
                  "properties": {
                    "letters": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "hex": {
                      "type": "string"
                    },
                    "metres": {
                      "type": "number"
                    },
                    "grams": {
                      "type": "number"
                    },
                    "skeins": {
                      "type": "integer"
                    },
                    "parts": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": true
    }
  },
  "required": [
    "view",
    "item"
  ],
  "additionalProperties": true
}
🟢match_materials(needle, fabric, yarn)

Checks whether a punch needle, a fabric and a yarn work together, using the website's material guidance. Returns the verdict for each part, what to change and the checks to make on a swatch.

Input Schema

{
  "type": "object",
  "properties": {
    "needle": {
      "type": "string",
      "description": "Needle family: Oxford regular point, Oxford fine yarn point, or a miniature embroidery punch needle for floss.",
      "minLength": 1,
      "maxLength": 60
    },
    "fabric": {
      "type": "string",
      "description": "Foundation fabric: rug-punching monk's cloth, rug linen, rug warp or punch-embroidery weaver's cloth.",
      "minLength": 1,
      "maxLength": 60
    },
    "yarn": {
      "type": "string",
      "description": "Yarn or fibre: rug yarn, bulky knitting yarn, worsted yarn, sport or sock yarn, or embroidery floss.",
      "minLength": 1,
      "maxLength": 60
    }
  },
  "required": [
    "needle",
    "fabric",
    "yarn"
  ],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "item": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description",
        "category",
        "url",
        "facts",
        "links",
        "matched"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "eyebrow": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "facts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "url"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "tables": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "columns",
              "rows"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "swatches": {
                "type": "array",
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "note": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "text"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "check": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "blocks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "heading"
            ],
            "properties": {
              "heading": {
                "type": "string"
              },
              "paragraphs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "matched": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    }
  },
  "required": [
    "view",
    "item"
  ],
  "additionalProperties": true
}
🟢get_material_guide(material, topic, name, guide)

Returns the website's guide to one punch needle material: needles, needle sizes, fabric, monk's cloth, yarn, floss, hoops or glue. The guide holds its sections, tables and related pages.

Input Schema

{
  "type": "object",
  "properties": {
    "material": {
      "type": "string",
      "description": "One of needles, needle sizes, fabric, monk's cloth, yarn, floss, hoops or glue.",
      "minLength": 1,
      "maxLength": 60
    },
    "topic": {
      "type": "string",
      "description": "Same value as material.",
      "minLength": 1,
      "maxLength": 60
    },
    "name": {
      "type": "string",
      "description": "Same value as material.",
      "minLength": 1,
      "maxLength": 60
    },
    "guide": {
      "type": "string",
      "description": "Same value as material.",
      "minLength": 1,
      "maxLength": 60
    }
  },
  "required": [],
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "detail"
      ]
    },
    "item": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description",
        "category",
        "url",
        "facts",
        "links",
        "blocks"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "eyebrow": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "image": {
          "type": "string"
        },
        "facts": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "value"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "links": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "label",
              "url"
            ],
            "properties": {
              "label": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "tables": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "columns",
              "rows"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "columns": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "rows": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "swatches": {
                "type": "array",
                "items": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "note": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "text"
            ],
            "properties": {
              "title": {
                "type": "string"
              },
              "text": {
                "type": "string"
              },
              "check": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        },
        "blocks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "heading"
            ],
            "properties": {
              "heading": {
                "type": "string"
              },
              "paragraphs": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true
    }
  },
  "required": [
    "view",
    "item"
  ],
  "additionalProperties": true
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools