# DingCard

> DingCard is an open-source MCP server for design and media. Make posters, social cards and slide decks from templates, check layout, export images. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted
- **Website:** https://dingcard.pages.dev
- **Repository:** https://github.com/lottshin/dingcard/tree/HEAD/mcp
- **MCP Registry name:** io.github.lottshin/dingcard
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

DingCard is an open-source editor for cards and posters, and its stdio MCP server lets an assistant drive the same document model. The README lists 22 tools: generate a document from a template, from raw content or from an outline, inspect and edit it with the editor's own reducer, list icons, ornaments, palettes, fonts, filters and puzzle layouts, and read a guide by topic.

What sets it apart is the check step. check_document lays the design out as it will export and lists problems such as overflowing or overlapping text, low contrast, leftover sample copy, tiny text, empty bands and too many fonts; with fix enabled, text that does not fit is shrunk. render_document then writes PNG, JPG, PDF, a long image or a 3x3 grid, and open_in_editor hands the result to a person in the browser editor.

It needs Node.js 22 or newer and a local Chrome for rendering, and fetches web fonts from Google Fonts unless you set another source. Tool descriptions are written in Chinese. The project is MIT-licensed.

## Features

- **Three ways to generate:** Create from a template, from content or from an outline.
- **Layout checking:** Flags overflow, overlap, low contrast, leftover sample text and more.
- **Auto-fix text:** Shrinks text that does not fit when fix is on.
- **Multiple export formats:** Renders PNG, JPG, PDF, long images or a 3x3 grid.
- **Editor handoff:** Opens the result in the browser editor for a person to finish.
- **Template library:** 88 templates in the site's template centre.

## Good for

- Turn an article into a set of social media cards
- Produce a poster from a template and fix text that overflows
- Generate a slide deck and export it as a PDF
- Review an AI-made design for contrast and alignment problems

## Install

### Claude Code (Terminal)

```sh
claude mcp add dingcard --env DINGCARD_SERVER_TOKEN='<DINGCARD_SERVER_TOKEN>' -- npx -y dingcard-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "dingcard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dingcard": {
      "command": "npx",
      "args": [
        "-y",
        "dingcard-mcp"
      ],
      "env": {
        "DINGCARD_SERVER_TOKEN": "<DINGCARD_SERVER_TOKEN>"
      }
    }
  }
}
```

## Tools

- `create_document_from_template`: Creates a document from a template.
- `create_document_from_content`: Creates a full card set from content, replacing sample text.
- `create_document_from_outline`: Creates a document from an outline.
- `inspect_document`: Inspects a document.
- `apply_actions`: Edits a document with the editor's own reducer.
- `list_assets`: Lists icons, ornaments, palettes, fonts, filters and puzzle layouts.
- `get_guide`: Reads the writing guide by topic.
- `check_document`: Lists visible layout problems as the design will export.
- `render_document`: Renders PNG, JPG, PDF or long image output.
- `render_markdown`: Renders Markdown into cards.
- `open_in_editor`: Opens the document in the browser editor.
- `get_document`: Returns the document.
- `list_templates`: Lists templates with size, purpose and style.
- `share_document`: Turns a design into a share link via a deployed server.

## FAQ

### What does it need locally?

Node.js 22 or newer and Google Chrome, which is used for checks and rendering.

### Is it open source?

Yes, under the MIT licence.

### What language are the tool descriptions in?

Chinese, according to the README.

### Can I share a design by link?

Yes, if you set DINGCARD_SERVER_URL and a token for a deployed DingCard server.

### Is DingCard free?

Yes. DingCard is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add dingcard --env DINGCARD_SERVER_TOKEN='<DINGCARD_SERVER_TOKEN>' -- npx -y dingcard-mcp

### What are the best alternatives to DingCard?

The closest alternatives to DingCard 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.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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