# Punchneedle.ai

> Punchneedle.ai is a free MCP server for design and media. Turn images into punch needle patterns and plan yarn, from any MCP client. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://punchneedle.ai
- **Repository:** https://github.com/pyxlino/punchneedle-mcp
- **MCP Registry name:** ai.punchneedle/punchneedle-ai
- **Categories:** design and media
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://punchneedle.ai/api/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/punchneedle-ai
