# designmark

> designmark is a free MCP server for design and media. Search and save DESIGN.md style guides from over 4,000 Japanese landing pages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Web
- **Website:** https://designmark.jp
- **Repository:** https://github.com/xecin-inc/designmark
- **MCP Registry name:** io.github.xecin-inc/designmark
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

designmark publishes DESIGN.md files, one per analysed Japanese landing page, that record colours, typography, spacing, components and section structure. Hand one to Claude Code, Cursor or another coding tool and it can build pages in the same look. The site counts about 4,366 published files across 25 industries and says it refreshes daily. Alongside them are pattern packs by industry and mood, licensed CC BY 4.0.

The npm package designmark works as a command line tool and also starts an MCP server over stdio. Searches require every word to match and can filter by industry, mood, main colour and phone or desktop view. show prints a design's colours with roles and HEX values, and add saves up to three designs into a project, optionally adding an @DESIGN.md line to CLAUDE.md so Claude Code reads it. Existing files are never overwritten without --force.

It needs Node.js 20 or later, and output can be switched between Japanese and English. Exit codes separate usage errors, not-found designs and temporary unavailability.

## Features

- **Filtered design search:** Searches by industry, mood, main colour and phone or desktop view, with every word required to match.
- **Colour and style detail:** Shows a design's title, style, moods and colours with role and HEX.
- **Save into a project:** Writes DESIGN.md or up to three files under design/ without overwriting by default.
- **CLAUDE.md hookup:** Can append an @DESIGN.md reference so Claude Code reads the file.
- **Pattern packs:** Industry and mood packs synthesised from many pages under CC BY 4.0.
- **Japanese or English output:** A language flag or environment variable switches the interface and JSON is available.

## Good for

- Find an elegant cosmetics landing page style and hand it to Claude Code
- Match the look of a clinic page on mobile
- Browse design packs by industry before starting a new page
- Save two reference designs into a project folder
- Script design lookups with JSON output

## Install

### Claude Code (Terminal)

```sh
claude mcp add designmark -- npx -y designmark
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "designmark": {
      "command": "npx",
      "args": [
        "-y",
        "designmark"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "designmark": {
      "command": "npx",
      "args": [
        "-y",
        "designmark"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "designmark": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "designmark"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "designmark": {
      "command": "npx",
      "args": [
        "-y",
        "designmark"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "designmark": {
      "command": "npx",
      "args": [
        "-y",
        "designmark"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

Run it with npx designmark, for example npx designmark search followed by a keyword. Node.js 20 or later is required.

### Is it free?

The site says the design files are distributed free, and pattern packs are CC BY 4.0.

### How do I start the MCP server?

Run the mcp command, which starts it over stdio.

### Will it overwrite my files?

No, existing files are never overwritten unless you pass --force.

### Is designmark free?

Yes. designmark is free to use.

### How do I add designmark to Claude Code?

Run this command in your terminal: claude mcp add designmark -- npx -y designmark

### What are the best alternatives to designmark?

The closest alternatives to designmark are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

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