{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:52:55.014Z","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp","markdownUrl":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp.md","server":{"slug":"ai-punchneedle-punchneedle-ai","name":"Punchneedle.ai","registryName":"ai.punchneedle/punchneedle-ai","description":"Make punch needle patterns from images, browse patterns, estimate yarn, resize and match materials.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"api-mcp","type":"remote","identifier":"https://punchneedle.ai/api/mcp","withdrawn":false,"url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp","version":"1.0.1","transport":null,"scoredAt":"2026-11-21T09:49:21.673Z"},"score":{"total":78,"tier":"medium","status":"scored","weekDelta":4,"history":[{"date":"2026-11-21","total":78},{"date":"2026-11-20","total":77},{"date":"2026-11-19","total":77},{"date":"2026-11-18","total":76},{"date":"2026-11-17","total":76},{"date":"2026-11-16","total":75},{"date":"2026-11-15","total":75},{"date":"2026-11-14","total":74},{"date":"2026-11-13","total":74},{"date":"2026-11-12","total":73},{"date":"2026-11-11","total":73}]},"categories":[{"name":"Endpoint Security","score":80,"verdict":"fail","reasons":["The endpoint's TLS certificate is valid, in date, and uses a strong key.","No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.","HTTPS is enforced; there's no plaintext access path.","The HSTS (Strict-Transport-Security) header is present.","DNSSEC check failed: this domain isn't protected by DNSSEC."],"codes":[{"code":"tls.valid","args":{}},{"code":"auth.none_no_destructive","args":{}},{"code":"https.enforced","args":{}},{"code":"headers.hsts_present","args":{}},{"code":"dnssec.absent","args":{}}]},{"name":"Transport & Reachability","score":100,"verdict":"pass","reasons":["Verified streamable-http transport via a live MCP handshake."],"codes":[{"code":"transport.verified","args":{"transport":"streamable-http"}}]},{"name":"Schema Quality & AI Usability","score":72,"verdict":"fail","reasons":["100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).","AI-judged instruction clarity (good).","Context-footprint check failed: tool/resource definitions use about 1618 tokens (~202/item across 8 items; 7 tools + 1 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.descriptions","args":{"pct":"100"}},{"code":"schema.ai_quality","args":{"band":"good"}},{"code":"schema.footprint_heavy","args":{"avg":"202","items":"8","tools":"7","tokens":"1618","resources":"1"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":33,"verdict":"partial","reasons":["Stability observed for 10 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"10"}}]},{"name":"Tool Coverage","score":100,"verdict":"pass","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","100% of tool parameters carry a description.","Structured output schemas are declared (100% of tools); any adoption earns full credit."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"100"}},{"code":"toolquality.output_present","args":{"pct":"100"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"7"}},{"code":"toolsafety.manipulation_clean","args":{"units":"9","judged":"9"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.","Supports UI / widget rendering."],"codes":[{"code":"protocol.supported","args":{"latest":"2026-07-28","version":"2025-11-25"}},{"code":"cap.ui_supported","args":{}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"api-mcp","type":"remote","identifier":"https://punchneedle.ai/api/mcp","withdrawn":false,"score":78,"current":true,"url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp","markdownUrl":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp.md"}],"facts":[{"label":"Endpoint","value":"https://punchneedle.ai/api/mcp"},{"label":"Transports","value":"streamable-http"},{"label":"Auth","value":"none"},{"label":"Version","value":"1.0.1"}],"install":{"available":true,"bundleSha256":null},"tools":[{"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.","inputs":[{"name":"colors","type":"integer","required":false,"description":"Same value as colours."},{"name":"colours","type":"integer","required":false,"description":"Largest number of yarn colours in the pattern, from 2 to 32. The default is 6."},{"name":"image","type":"string","required":false,"description":"Same value as image_url."},{"name":"imageUrl","type":"string","required":false,"description":"Same value as image_url."},{"name":"image_url","type":"string","required":false,"description":"Public web address (https) of a PNG, JPEG or WebP image of at most 4 MB."},{"name":"size","type":"number","required":false,"description":"Same value as width."},{"name":"unit","type":"string","required":false,"description":"Unit of the width; the default is cm."},{"name":"url","type":"string","required":false,"description":"Same value as image_url."},{"name":"width","type":"number","required":false,"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."}],"outputs":[{"name":"item","type":"object","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":243},{"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.","inputs":[{"name":"category","type":"string","required":false,"description":"Same value as theme."},{"name":"collection","type":"string","required":false,"description":"Same value as theme."},{"name":"difficulty","type":"string","required":false,"description":"Same value as level."},{"name":"level","type":"string","required":false,"description":"Level of the patterns: beginner for the website's beginner collection, or any for all patterns."},{"name":"query","type":"string","required":false,"description":"Same value as theme."},{"name":"theme","type":"string","required":false,"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."}],"outputs":[{"name":"items","type":"array","required":true,"description":null},{"name":"links","type":"array","required":false,"description":null},{"name":"nextCursor","type":"string|null","required":true,"description":null},{"name":"notes","type":"array","required":false,"description":null},{"name":"pageSize","type":"integer","required":true,"description":null},{"name":"request","type":"object","required":true,"description":null},{"name":"subtitle","type":"string","required":false,"description":null},{"name":"title","type":"string","required":false,"description":null},{"name":"total","type":"integer","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":153},{"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.","inputs":[{"name":"id","type":"string","required":false,"description":"Same value as pattern."},{"name":"name","type":"string","required":false,"description":"Same value as pattern."},{"name":"pattern","type":"string","required":false,"description":"Pattern id such as cat or sunflower, the pattern's name, or its page address on Punchneedle.ai."},{"name":"slug","type":"string","required":false,"description":"Same value as pattern."}],"outputs":[{"name":"item","type":"object","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":102},{"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.","inputs":[{"name":"buffer","type":"number","required":false,"description":"Same value as extra_percent."},{"name":"colors","type":"array","required":false,"description":"Same value as colours."},{"name":"colours","type":"array","required":false,"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."},{"name":"extra_percent","type":"number","required":false,"description":"Extra yarn for tails and finishing in percent, from 0 to 100. The default is 15."},{"name":"height","type":"number","required":false,"description":"Height of a rectangular design in the chosen unit; a circle needs none."},{"name":"loop_height_mm","type":"number","required":false,"description":"Loop height in mm: 3.2, 4.8, 6.4, 9.5 or 12.7."},{"name":"needle","type":"string","required":false,"description":"Oxford needle such as #14 fine, #13 fine, #10 fine, #10 regular, #9 regular or #8 regular. The default is #14 fine."},{"name":"shape","type":"string","required":false,"description":"Shape of the design; the default is rectangle."},{"name":"skein_length_m","type":"number","required":false,"description":"Length in metres of one skein of the project yarn."},{"name":"swatch_height_cm","type":"number","required":false,"description":"Height in cm of the measured swatch."},{"name":"swatch_width_cm","type":"number","required":false,"description":"Width in cm of a measured filled swatch; the four swatch values come together."},{"name":"swatch_yarn_m","type":"number","required":false,"description":"Metres of yarn used in the measured swatch."},{"name":"unit","type":"string","required":false,"description":"Unit of the width and height; the default is cm."},{"name":"width","type":"number","required":false,"description":"Width of the design, or the diameter of a circle, in the chosen unit."}],"outputs":[{"name":"item","type":"object","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":384},{"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.","inputs":[{"name":"height","type":"number","required":false,"description":"Current height of a design that is not a library pattern, in the chosen unit."},{"name":"id","type":"string","required":false,"description":"Same value as pattern."},{"name":"new_height","type":"number","required":false,"description":"New height in the chosen unit, up to 2000 mm. The width follows the proportions."},{"name":"new_width","type":"number","required":false,"description":"New width in the chosen unit, from 10 mm to 2000 mm. The height follows the proportions."},{"name":"pattern","type":"string","required":false,"description":"Library pattern id such as cat or sunflower, or its name."},{"name":"unit","type":"string","required":false,"description":"Unit of the sizes; the default is cm."},{"name":"width","type":"number","required":false,"description":"Current width of a design that is not a library pattern, in the chosen unit."}],"outputs":[{"name":"item","type":"object","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":212},{"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.","inputs":[{"name":"fabric","type":"string","required":true,"description":"Foundation fabric: rug-punching monk's cloth, rug linen, rug warp or punch-embroidery weaver's cloth."},{"name":"needle","type":"string","required":true,"description":"Needle family: Oxford regular point, Oxford fine yarn point, or a miniature embroidery punch needle for floss."},{"name":"yarn","type":"string","required":true,"description":"Yarn or fibre: rug yarn, bulky knitting yarn, worsted yarn, sport or sock yarn, or embroidery floss."}],"outputs":[{"name":"item","type":"object","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":139},{"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.","inputs":[{"name":"guide","type":"string","required":false,"description":"Same value as material."},{"name":"material","type":"string","required":false,"description":"One of needles, needle sizes, fabric, monk's cloth, yarn, floss, hoops or glue."},{"name":"name","type":"string","required":false,"description":"Same value as material."},{"name":"topic","type":"string","required":false,"description":"Same value as material."}],"outputs":[{"name":"item","type":"object","required":true,"description":null},{"name":"view","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":111}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T09:49:21.000Z","track":"remote","endpoint":"https://punchneedle.ai/api/mcp","declaredUrl":null,"truncated":false,"tls":{"outcome":"valid","label":"Valid","version":"TLS 1.3","cipherSuite":"TLS_AES_128_GCM_SHA256","chainError":null,"certificates":[{"subject":"CN=punchneedle.ai","issuer":"CN=YR2,O=Let's Encrypt,C=US","notBefore":"2026-09-25T12:47:08Z","notAfter":"2026-12-24T12:47:07Z","keyType":"RSA","keyBits":2048,"isCa":false},{"subject":"CN=YR2,O=Let's Encrypt,C=US","issuer":"CN=Root YR,O=ISRG,C=US","notBefore":"2025-09-03T00:00:00Z","notAfter":"2028-09-02T23:59:59Z","keyType":"RSA","keyBits":2048,"isCa":true},{"subject":"CN=Root YR,O=ISRG,C=US","issuer":"CN=ISRG Root X1,O=Internet Security Research Group,C=US","notBefore":"2026-05-13T00:00:00Z","notAfter":"2032-09-02T23:59:59Z","keyType":"RSA","keyBits":4096,"isCa":true}]},"dnssec":{"result":"insecure","label":"Not signed","name":"punchneedle.ai.","steps":[{"zone":".","outcome":"verified","label":"Verified"},{"zone":"ai.","outcome":"verified","label":"Verified"},{"zone":"punchneedle.ai.","outcome":"insecure_proven","label":"Unsigned (proven)"}]},"auth":{"outcome":"none","label":"No authorisation required","gate":null,"gateLabel":null,"status":200,"authorizationServers":[]},"httpsRedirect":{"outcome":"https_enforced","label":"HTTPS enforced","status":308},"transports":[{"transport":"streamable-http","outcome":"verified","label":"Verified","status":200,"followed":false}],"provenance":null,"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":null},"mismatches":[],"changelog":{"trackingSince":"2026-11-11","recent":[{"id":"chg_01a1fd82-ab9f-79cb-bde6-22ac616e24d0","kind":"score.total_changed","summary":"Trust score (77 → 78)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-21","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1fd82-ab9f-79cb-bde6-22ac616e24d0"},{"id":"chg_01a1f33b-3859-7bef-bc95-782ed6bdb1e5","kind":"score.total_changed","summary":"Trust score (76 → 77)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1f33b-3859-7bef-bc95-782ed6bdb1e5"},{"id":"chg_01a1e8e7-5a1c-7312-b17e-855e00645f86","kind":"score.total_changed","summary":"Trust score (75 → 76)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1e8e7-5a1c-7312-b17e-855e00645f86"},{"id":"chg_01a1de98-c2e0-7452-8f84-5a70cac8ed22","kind":"score.total_changed","summary":"Trust score (74 → 75)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1de98-c2e0-7452-8f84-5a70cac8ed22"},{"id":"chg_01a1d449-f2d6-7919-9352-9c380f39f3b7","kind":"score.total_changed","summary":"Trust score (73 → 74)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1d449-f2d6-7919-9352-9c380f39f3b7"},{"id":"chg_01a1cd13-719e-79a1-aa7f-60a41c1c745e","kind":"check.reverified","summary":"Stability (unverified → 0.03)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-12","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1cd13-719e-79a1-aa7f-60a41c1c745e"},{"id":"chg_01a1ccd7-383d-7130-b344-1b5d6067a023","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp#chg-chg_01a1ccd7-383d-7130-b344-1b5d6067a023"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp","markdown":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp.md","changelogJson":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/ai-punchneedle-punchneedle-ai/api-mcp.xml","external":[{"label":"Remote endpoint","href":"https://punchneedle.ai/api/mcp"},{"label":"Repository","href":"https://github.com/pyxlino/punchneedle-mcp"},{"label":"Website","href":"https://punchneedle.ai/"}]}}