impeccable
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Generate ShapeWords word clouds as SVG, PNG, or JSON from text or weighted words.
この種の作業を AI に教える Skill。これと一緒に使えます
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.
Create beautiful slides on the web using a coding agent's frontend skills
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 3/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 3/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
ShapeWords MCP をインストールして。https://mcp.popnx.com/i/kirrrr-2423-shapewords-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server ShapeWords MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "shapewords": { "command": "npx", "args": [ "-y", "shapewords-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、ShapeWords MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
SettingsDeveloperEdit Config
{
"mcpServers": {
"shapewords": {
"command": "npx",
"args": [
"-y",
"shapewords-mcp"
]
}
}
}ShapeWords MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が ShapeWords MCP を使っていると言うか、回答に ShapeWords MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SHAPEWORDS_API_BASE_URL ShapeWords Render API のベース URL。既定値は公開の ShapeWords サービスです SHAPEWORDS_RENDER_API_KEY 保護された ShapeWords Render API デプロイメント用の任意の bearer トークン。 SHAPEWORDS_POLL_TIMEOUT_MS ホスト型レンダリングジョブを待機する最大時間(ミリ秒)。 SHAPEWORDS_REQUEST_TIMEOUT_MS ShapeWords API 呼び出しのリクエストごとのタイムアウト(ミリ秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ ShapeWords MCP につなげません
ShapeWords MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · ShapeWords MCP につなげるアプリを使う
B · デザイン・画像・音声 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server ShapeWords MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user shapewords -- npx -y shapewords-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、ShapeWords MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user shapewords -- npx -y shapewords-mcpShapeWords MCP が一覧にあり、接続済みと表示されれば OK です
ShapeWords MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が ShapeWords MCP を使っていると言うか、回答に ShapeWords MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SHAPEWORDS_API_BASE_URL ShapeWords Render API のベース URL。既定値は公開の ShapeWords サービスです SHAPEWORDS_RENDER_API_KEY 保護された ShapeWords Render API デプロイメント用の任意の bearer トークン。 SHAPEWORDS_POLL_TIMEOUT_MS ホスト型レンダリングジョブを待機する最大時間(ミリ秒)。 SHAPEWORDS_REQUEST_TIMEOUT_MS ShapeWords API 呼び出しのリクエストごとのタイムアウト(ミリ秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server ShapeWords MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "shapewords": { "command": "npx", "args": [ "-y", "shapewords-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、ShapeWords MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
ShapeWords MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が ShapeWords MCP を使っていると言うか、回答に ShapeWords MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SHAPEWORDS_API_BASE_URL ShapeWords Render API のベース URL。既定値は公開の ShapeWords サービスです SHAPEWORDS_RENDER_API_KEY 保護された ShapeWords Render API デプロイメント用の任意の bearer トークン。 SHAPEWORDS_POLL_TIMEOUT_MS ホスト型レンダリングジョブを待機する最大時間(ミリ秒)。 SHAPEWORDS_REQUEST_TIMEOUT_MS ShapeWords API 呼び出しのリクエストごとのタイムアウト(ミリ秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server ShapeWords MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "shapewords": { "type": "stdio", "command": "npx", "args": [ "-y", "shapewords-mcp" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、ShapeWords MCP のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
ShapeWords MCP を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が ShapeWords MCP を使っていると言うか、回答に ShapeWords MCP のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
SHAPEWORDS_API_BASE_URL ShapeWords Render API のベース URL。既定値は公開の ShapeWords サービスです SHAPEWORDS_RENDER_API_KEY 保護された ShapeWords Render API デプロイメント用の任意の bearer トークン。 SHAPEWORDS_POLL_TIMEOUT_MS ホスト型レンダリングジョブを待機する最大時間(ミリ秒)。 SHAPEWORDS_REQUEST_TIMEOUT_MS ShapeWords API 呼び出しのリクエストごとのタイムアウト(ミリ秒)。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user shapewords -- npx -y shapewords-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"shapewords": {
"command": "npx",
"args": [
"-y",
"shapewords-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"shapewords": {
"command": "npx",
"args": [
"-y",
"shapewords-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"shapewords": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"shapewords-mcp"
]
}
}
}SHAPEWORDS_API_BASE_URL envSHAPEWORDS_RENDER_API_KEY 秘密 envSHAPEWORDS_POLL_TIMEOUT_MS envSHAPEWORDS_REQUEST_TIMEOUT_MS env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
npm: shapewords-mcpこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント kirrrr-2423 で確認済みです
コードの最終更新:6 か月前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に shapewords-mcp@0.2.2 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/kirrrr-2423-shapewords-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は6 か月前、最新バージョン(0.2.2)がレジストリに届いたのは6 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
The Figma MCP server brings Figma design context directly into your AI workflow.
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| これ ShapeWords MCP | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | はい | いいえ | いいえ | はい | いいえ |
| 基本チェック | 3/3 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| ライセンス | MIT | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Universal MCP server for generating word clouds with ShapeWords.
It exposes ShapeWords rendering tools through the Model Context Protocol, so any MCP-capable client can create SVG, JSON, or PNG word clouds from text, workshop notes, prompts, research snippets, or agent output. By default it uses the hosted ShapeWords Render API; with engine: "skia" it renders locally inside the MCP server with the shared layout core and CanvasKit/Skia.
All tools use stdio MCP transport.
render_word_cloudCreates a ShapeWords render job, polls until it is finished, and returns:
engine: "skia";Use this tool for one-shot generation when the caller wants the final artifact.
create_word_cloud_jobStarts a render job and returns the job/status/artifact URLs without waiting.
Use this tool for asynchronous workflows where the client will poll later.
get_word_cloud_jobChecks a render job by ID.
Use this tool with the jobId returned by create_word_cloud_job or render_word_cloud.
render_word_cloud accepts all render options below. create_word_cloud_job accepts the hosted options only: engine: "skia" is local-only and is supported by render_word_cloud.
| Field | Type | Default | Limits | Description |
|---|---|---|---|---|
renderProfile | enum | canvas | canvas, api | Default option profile. canvas matches the main ShapeWords canvas; api keeps the older compact Render API defaults. |
text | string | optional | 1-100,000 chars | Source text for the word cloud. Required unless words is provided. |
words | object[] | optional | 1-1000 items | Explicit weighted words. Use when the caller already tokenized, lemmatized, or scored text. |
locale | enum | en | en, ru, ar, es, fr, zh | Render/UI locale passed to ShapeWords. |
format | enum | svg | svg, png, json | Artifact format. SVG is the fastest default. JSON returns layout data. PNG is rasterized from the same shared layout. |
width | integer | 800 | 240-4096 | Canvas width in pixels. |
height | integer | 600 | 240-4096 | Canvas height in pixels. |
background | enum | white | transparent, white, dark | Output background. |
quality | enum | hq | sq, hq | Standard or high-quality render. hq matches the main canvas export scale and is slower. |
engine | enum | auto | auto, browser, browserless, skia | Renderer engine. skia uses the local MCP shared-core + CanvasKit renderer without server-side Chromium. |
returnLayout | boolean | false | true/false | Include layout metadata when supported. |
shapeType | string | cloud | 1-80 chars | Shape id. Use a built-in id or custom with customShapeDefinition. |
customShapeDefinition | object | omitted | see below | Custom SVG path shape. Required when shapeType is custom. |
maxWords | integer | 700 | 1-1000 | Maximum number of words to place. |
seed | integer | 0 | 0-4294967295 | Unsigned 32-bit layout seed for reproducible browserless renders. Same input, options, and seed produce the same SVG/layout. |
fontFamily | string | Montserrat | 1-80 chars | ShapeWords font family name, for example Inter, Roboto, Montserrat, Noto Sans. |
minFontSize | integer | 18 | 4-400 | Minimum word font size. |
maxFontSize | integer | 96 | 8-700 | Maximum word font size. |
padding | integer | 3 | 0-100 | Pixel padding used by collision detection. |
rotationPreset | enum | orthogonal | see below | Rotation preset matching the main ShapeWords canvas. |
rotations | integer[] | omitted | -90 to 90, max 64 values | Explicit rotation angles. When provided, these override rotationPreset. |
spiralType | enum | archimedean | archimedean, rectangular | Placement spiral algorithm. |
fillMode | enum | fill | fill, frequency | Shape filling strategy. |
palette | string[] | service default | up to 12 colors | Hex colors: #rgb, #rrggbb, or #rrggbbaa. |
colorMode | enum | service default | sequential, random, byFrequency | How palette colors are assigned to words. |
returnImage | boolean | false | render_word_cloud only | Download the finished SVG/PNG artifact and return it as MCP image content. |
pollIntervalMs | integer | env/default | 250-10,000 | Polling interval for render_word_cloud. |
pollTimeoutMs | integer | env/default | 1,000-180,000 | Maximum wait time for render_word_cloud. |
get_word_cloud_job accepts:
| Field | Type | Limits | Description |
|---|---|---|---|
jobId | string | 6-64 chars | ShapeWords render job id. |
words items use this shape:
| Field | Type | Default | Limits | Description |
|---|---|---|---|---|
text | string | required | 1-120 chars | Display word or emoji. |
value | integer | 1 | 1-100,000 | Weight/frequency used for sizing. |
kind | enum | word | word, emoji | Word type. Emoji are kept horizontal by the renderer. |
sizeScale | number | omitted | 0.1-5 | Optional extra size multiplier used by the ShapeWords layout core when available. |
repeat | boolean | true | true/false | Whether the layout may repeat this word to improve shape filling. |
Rotation presets:
horizontal, vertical, orthogonal, crossing, crossingVoids, dancing,
positiveSlope, negativeSlope, random, custom, mixed, angled, free
renderProfile: "canvas" sends the same practical defaults as the main editor canvas: shapeType: "cloud", width: 800, height: 600, quality: "hq", maxWords: 700, seed: 0, fontFamily: "Montserrat", minFontSize: 18, maxFontSize: 96, padding: 3, rotationPreset: "orthogonal", spiralType: "archimedean", and fillMode: "fill".
Use renderProfile: "api" only when you need the older compact Render API defaults: circle shape, 1024x640, SQ quality, and 120 max words.
The MCP server can send either raw text, explicit words, or both:
cloud cloud cloud render render API;words[] preserves caller-provided weights and avoids differences in tokenization, stop words, or lemmatization;text and words[] are present, ShapeWords renders from words[] and keeps text as source context;Example weighted text:
{
"text": "MCP MCP MCP ShapeWords ShapeWords word cloud word cloud render API agents tools", "shapeType": "cloud", "format": "svg", "seed": 12345 }
Example explicit weighted words:
{
"words": [ { "text": "ShapeWords", "value": 12 }, { "text": "MCP", "value": 9 }, { "text": "canvas", "value": 7 }, { "text": "layout", "value": 6 }, { "text": "render", "value": 5 } ], "shapeType": "cloud", "format": "svg" }
Use shapeType to choose the word-cloud mask.
Stable built-in shape ids accepted by the production renderer include:
rectangle, circle, heart, star, cloud, diamond, tree, triangle, arrow,
square, pentagon, hexagon, octagon, cross, plus, moon, sun, drop, flame, leaf, flower, mountain, apple, house, book, camera, music, chat, location, trophy, rocket, plane, car, shield, lightning, check, infinity, tag
Built-in brand shape ids include:
brand-product-hunt, brand-y-combinator, brand-hacker-news,
brand-indie-hackers, brand-github, brand-figma, brand-notion, brand-stripe, brand-vercel, brand-linear, brand-supabase, brand-railway, brand-netlify, brand-firebase, brand-cloudflare, brand-airtable, brand-replit, brand-anthropic
The production renderer may also accept additional generated ShapeWords ids. For portable automation, prefer the stable ids above or pass a custom SVG shape.
The local engine: "skia" path currently supports rectangle, square, circle, diamond, triangle, star, heart, cloud, custom SVG shapes, and vendored Font Awesome shape ids such as fa-cat. Unsupported local shape ids are rejected instead of silently changing the requested shape.
Set shapeType to custom and provide customShapeDefinition:
| Field | Type | Required | Limits | Description |
|---|---|---|---|---|
path | string | yes | 1-100,000 chars | SVG path data used as the mask. |
viewBox | string | yes | 1-120 chars | SVG viewBox, for example 0 0 100 100. |
fillRule | enum | no | nonzero, evenodd | SVG fill rule. Defaults to renderer behavior when omitted. |
name | string | no | 1-80 chars | Optional human-readable name. |
nameEn | string | no | 1-80 chars | Optional English name. |
Custom heart example:
{
"text": "love love design care product community team support", "shapeType": "custom", "customShapeDefinition": { "name": "Heart", "path": "M 50 90 C 25 70, 0 50, 0 30 A 25 25 0 0 1 50 30 A 25 25 0 0 1 100 30 C 100 50, 75 70, 50 90 Z", "viewBox": "0 0 100 100", "fillRule": "nonzero" }, "format": "svg" }
render_word_cloud returns:
structuredContent.job with normalized job metadata;structuredContent.artifactUrl for hosted renders;structuredContent.localArtifact for engine: "skia";structuredContent.siteUrl;returnImage is true and format is svg or png.For engine: "skia", render_word_cloud always returns inline MCP image content for format: "png" or format: "svg" because there is no hosted artifact URL.
create_word_cloud_job returns the same metadata immediately after job creation, without waiting for completion.
get_word_cloud_job returns the latest job status and artifact URL.
Generated artifact URLs are short-lived because the ShapeWords Render API stores render jobs in memory.
svg is the recommended automation format: it is fast, compact, and works with the browserless shared-core renderer.json returns layout data from the same shared-core placement.png is rasterized from the same generated SVG/layout, so word placement matches SVG/JSON for the same input and options.engine: "auto" is recommended unless you need to force a specific path.engine: "browserless" supports svg, json, and png.engine: "browser" supports svg and png, not json.engine: "skia" is local-only and supported by render_word_cloud. It does not create pollable hosted jobs. Layout is generated by the vendored ShapeWords shared core; PNG is drawn directly with CanvasKit/Skia.seed is honored by browserless/shared-core renders. Use engine: "auto" or engine: "browserless" for reproducible API/MCP output.seed with forced engine: "browser" is rejected by the Render API because the browser fallback does not use the deterministic shared-core seed path.Run directly from GitHub:
npx -y github:kirrrr-2423/shapewords-mcp
Or clone locally:
git clone https://github.com/kirrrr-2423/shapewords-mcp.git
cd shapewords-mcp npm install npm start
Use stdio transport in any MCP-compatible client.
{
"mcpServers": { "shapewords": { "command": "npx", "args": ["-y", "github:kirrrr-2423/shapewords-mcp"], "env": { "SHAPEWORDS_API_BASE_URL": "https://shapewords.fun" } } } }
For a local clone:
{
"mcpServers": { "shapewords": { "command": "node", "args": ["/absolute