{"data":{"name":"ai.punchneedle/punchneedle-ai","title":"Punchneedle.ai","description":"Make punch needle patterns from images, browse patterns, estimate yarn, resize and match materials.","version":"1.0.1","websiteUrl":"https://punchneedle.ai","repositoryUrl":"https://github.com/pyxlino/punchneedle-mcp","remotes":[{"type":"streamable-http","url":"https://punchneedle.ai/api/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-11T23:23:05.981Z","updatedAt":"2026-11-11T23:23:05.981Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"ai.punchneedle/punchneedle-ai","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-11T23:23:05.981Z","title":"Punchneedle.ai","description":"Make punch needle patterns from images, browse patterns, estimate yarn, resize and match materials.","websiteUrl":"https://punchneedle.ai","repositoryUrl":"https://github.com/pyxlino/punchneedle-mcp"}],"toolIndex":{"tools":[{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"calculate_yarn","title":"Calculate yarn","description":"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.","inputSchema":{"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},"annotations":{"title":"Calculate yarn","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"649b2390c9ceb5bc9c441cb3f8dd8018a739cbd84d4b923cd93002b9a4b92b57","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"},{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"find_patterns","title":"Find patterns","description":"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.","inputSchema":{"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},"annotations":{"title":"Find patterns","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"734ceea918ee2fe06afe33b8ae6c1c215180367ee95787cc74858efd6eafee23","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"},{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"get_material_guide","title":"Read a material guide","description":"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.","inputSchema":{"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},"annotations":{"title":"Read a material guide","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1c1d6da05271645881494515c4489a1c05e073ecf04c68484072512eeb3aa503","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"},{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"get_pattern","title":"Read a pattern","description":"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.","inputSchema":{"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},"annotations":{"title":"Read a pattern","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8d3e78636d613370c67168d8d0b9460f989b2f2fb4db77cb669ea291fe105f9b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"},{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"make_pattern_from_image","title":"Make a pattern from an image","description":"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.","inputSchema":{"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},"annotations":{"title":"Make a pattern from an image","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"b42c484df9f21baa516ed0baffc9bff8f541e8bca13e07e8c5441daa0b6cf88c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"},{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"match_materials","title":"Match materials","description":"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.","inputSchema":{"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},"annotations":{"title":"Match materials","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"db6fada5990c5cadcad4db6f7a6687a4afe02c583aa2595379e5e2146f9cc6ba","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"},{"serverName":"ai.punchneedle/punchneedle-ai","endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","name":"resize_pattern","title":"Resize a pattern","description":"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.","inputSchema":{"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},"annotations":{"title":"Resize a pattern","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"28ad68967b283ab408e465ba889aea0189e69f7b72080d0aea4b036bd04c5f84","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T14:46:47.425Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"25c321a345ccbb62b8f6eb60ce7d98c5cc1e0f34189c840ecbc86bceed3b93f2","protocol":"streamable-http","status":"indexed","toolCount":7,"observedAt":"2026-11-18T14:46:47.425Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"ai.punchneedle/punchneedle-ai":{"url":"https://punchneedle.ai/api/mcp"}}},"Cursor":{"mcpServers":{"ai.punchneedle/punchneedle-ai":{"url":"https://punchneedle.ai/api/mcp"}}},"VS Code":{"servers":{"ai.punchneedle/punchneedle-ai":{"type":"http","url":"https://punchneedle.ai/api/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://punchneedle.ai/api/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:ai.punchneedle%2Fpunchneedle-ai","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/ai.punchneedle%2Fpunchneedle-ai","name":"ai.punchneedle/punchneedle-ai","description":"Make punch needle patterns from images, browse patterns, estimate yarn, resize and match materials.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://punchneedle.ai/api/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://punchneedle.ai","repositoryUrl":"https://github.com/pyxlino/punchneedle-mcp","version":"1.0.1"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"ai.punchneedle/punchneedle-ai","status":"online","lastCheckedAt":"2026-11-20T06:15:44.551Z","lastSuccessfulCheck":"2026-11-20T06:15:44.551Z","latencyMs":175,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T06:15:44.551Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T06:15:44.551Z"},"security":null,"timestamps":{"createdAt":"2026-11-11T23:23:05.981Z","updatedAt":"2026-11-11T23:23:05.981Z","observedAt":"2026-11-20T06:15:44.551Z"},"compatibility":{"serverVersion":"1.0.1","protocolVersions":[{"protocol":"mcp","version":null}]}}}}