# WIA Code & WIA Pin Code

> WIA Code & WIA Pin Code is a free MCP server for design and media. Make shape-free 2D codes and convert coordinates to and from WIA Pin Codes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://wiacode.com/developers.html
- **MCP Registry name:** com.wiacode/wiacode
- **Categories:** design and media, maps and travel
- **Listing updated:** 2026-11-16

## About

WIA Code is a 2D code format from SmileStory that can take silhouette shapes such as heart, star, round and square, each with its own capacity in bytes (square holds 1,450, heart 854, star 386). The server can make codes from plain text or from ready-made Wi-Fi, contact-card (vCard) and event (iCalendar) types, with the server building the standard string from fields. A booster QR is always included and cannot be switched off.

Tools are get_wia_code_info, generate_wia_code, generate_wia_code_wifi, generate_wia_code_card, generate_wia_code_event, pin_code_encode, pin_code_decode and pin_code_nearby. Pin Codes turn a latitude and longitude into a 12-digit location code, decode them back with roughly 10 m latitude and 20 m longitude accuracy, and list nearby cells within 10 to 200 m.

Free use needs no key and is limited to 10 requests a minute per IP, and each generation can take up to four seconds because the server verifies the code reads back. The same service is offered as a REST API and an npx CLI.

## Features

- **Shaped codes:** Generates codes in heart, star, round, square and other silhouettes.
- **Wi-Fi, card and event:** Builds codes that join networks, save contacts or add events.
- **Capacity guidance:** Reports which shape fits a given payload.
- **Pin Code encode:** Converts coordinates to a 12-digit location code.
- **Pin Code decode and nearby:** Returns coordinates and nearby cells with distance and bearing.
- **Self-checked output:** Verifies each code reads back before returning it.

## Good for

- Make a heart-shaped code for a wedding invitation link
- Print a Wi-Fi code guests can scan to join
- Share a contact card as a scannable code
- Convert a location to a short Pin Code for sharing

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http wiacode https://mcp.wiacode.com/mcp
```

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

```sh
https://mcp.wiacode.com/mcp
```

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

```json
{
  "mcpServers": {
    "wiacode": {
      "url": "https://mcp.wiacode.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "wiacode": {
      "type": "http",
      "url": "https://mcp.wiacode.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "wiacode": {
      "serverUrl": "https://mcp.wiacode.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "wiacode": {
      "type": "http",
      "url": "https://mcp.wiacode.com/mcp"
    }
  }
}
```

## Tools

- `get_wia_code_info`: Explains WIA Code and shape capacities.
- `generate_wia_code`: Makes a code image from text.
- `generate_wia_code_wifi`: Makes a Wi-Fi credentials code.
- `generate_wia_code_card`: Makes a contact vCard code.
- `generate_wia_code_event`: Makes an iCalendar event code.
- `pin_code_encode`: Converts latitude and longitude to a Pin Code.
- `pin_code_decode`: Converts a Pin Code to coordinates.
- `pin_code_nearby`: Lists Pin Code cells near a point.

## FAQ

### Is a key required?

No. Within the free limit of 10 requests a minute per IP, no key is needed.

### Can I turn off the booster QR?

No. The site says the booster is always included in the API, MCP and CLI.

### How accurate is a decoded Pin Code?

Roughly 10 m in latitude and 20 m in longitude.

### How much can a code hold?

It depends on the shape: up to 1,450 bytes for a square.

### Is WIA Code & WIA Pin Code free?

Yes. WIA Code & WIA Pin Code is free to use.

### How do I add WIA Code & WIA Pin Code to Claude Code?

Run this command in your terminal: claude mcp add --transport http wiacode https://mcp.wiacode.com/mcp

### What are the best alternatives to WIA Code & WIA Pin Code?

The closest alternatives to WIA Code & WIA Pin Code are HyperFrames by HeyGen, ffmpeg-skill, Tutu eSIM, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## 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.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [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.

---
Source: https://ai-powered.com/mcp/wia-code-and-wia-pin-code
