Skip to content
MCP server

Punchneedle.ai

Turn images into punch needle patterns and plan yarn, from any MCP client

Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.1
Listing updated
1 day ago

About Punchneedle.ai

Punchneedle.ai is a free MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.

Punch needle needs more than a picture: a stitch grid, a colour count and a yarn estimate for each colour. This connector hands those jobs to the Punchneedle.ai converter and calculators. Give it a public PNG, JPEG or WebP address, a finished width and a colour limit, and it returns a stitch-grid pattern with the yarn each colour needs.

The library side lists the site's original patterns by theme and level, and returns one with its size, colours, steps, materials and yarn amounts for a fine-wool kit and a rug-wool kit. Other tools rescale a pattern to a new width or height with proportions kept, and check whether a needle, fabric and yarn suit each other.

All tools are read-only, and the endpoint needs no account, sign-in or API key. The repository documents the hosted connector and does not contain the website's code.

Install

Run in a terminal

claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcp

Add to Settings → Connectors → Add custom connector

https://punchneedle.ai/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "punchneedle-ai": {
      "url": "https://punchneedle.ai/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "punchneedle-ai": {
      "type": "http",
      "url": "https://punchneedle.ai/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (7)

Read directly from the server.

make_pattern_from_image
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.
find_patterns
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.
get_pattern
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.
calculate_yarn
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.
resize_pattern
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.
match_materials
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.
get_material_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.

What it does

Image to pattern
Converts a public image into a stitch grid with a colour limit and yarn per colour.
Pattern library
Lists original patterns by theme and level and returns full details for one.
Yarn estimates
Estimates yarn from size, colour share, needle and loop height, or a measured swatch.
Resize patterns
Rescales a pattern to a new width or height with proportions kept.
Material matching
Checks whether a needle, fabric and yarn work together.

Good for

  • Turn a photo into a printable rug-punching design
  • Estimate how much yarn a design needs before buying
  • Find a beginner pattern on a given theme
  • Check a needle and fabric pairing before starting

Pricing

Free

No sign-in or key needed for the connector

Prices change. Check punchneedle.ai before you buy.

Punchneedle.ai FAQ

Do I need an account?

No. The README says authentication is none: no account, sign-in or API key.

Which image formats work?

Public PNG, JPEG or WebP images, up to 10 MB on the website.

Can it change anything?

No. All tools are read-only.

How do I add it to Claude?

Open Customize, then Connectors, choose Add custom connector and enter https://punchneedle.ai/api/mcp.

Is Punchneedle.ai free?

Yes. Punchneedle.ai is free to use.

How do I add Punchneedle.ai to Claude Code?

Run this command in your terminal: claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcp

What are the best alternatives to Punchneedle.ai?

The closest alternatives to Punchneedle.ai are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to Punchneedle.ai

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media