ShapeWords MCP
Wraps the ShapeWords rendering engine so Claude can generate word clouds as SVG, PNG, or JSON directly from conversation text or weighted word lists. Exposes three tools: render_word_cloud for one-shot generation with polling, create_word_cloud_job for async workflows, and get_word_cloud_job for status checks. You can pass raw text and let ShapeWords tokenize it, or send explicit word weights when you need control over sizing. Supports 40+ built-in shapes (cloud, heart, star, brand logos), custom SVG paths, and full control over dimensions, fonts, rotation presets, color palettes, and layout seeds for reproducible output. Runs against the hosted API by default or locally with engine: "skia" for offline rendering. Useful when you want to visualize meeting notes, research snippets, or any text Claude processes without leaving the protocol.
- tools
- 3
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Jun 5, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
render_word_cloudCreates a ShapeWords render job, polls until it is finished, and returns the artifact URL or inline artifact, job metadata, and optional image content.
Creates a ShapeWords render job, polls until it is finished, and returns the artifact URL or inline artifact, job metadata, and optional image content.
No parameter schema in public metadata yet.
create_word_cloud_jobStarts a render job and returns the job/status/artifact URLs without waiting.
Starts a render job and returns the job/status/artifact URLs without waiting.
No parameter schema in public metadata yet.
get_word_cloud_jobChecks a render job by ID.
Checks a render job by ID.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SHAPEWORDS_API_BASE_URLdefault: https://shapewords.funShapeWords Render API base URL. Defaults to the public ShapeWords service.
SHAPEWORDS_RENDER_API_KEYsecretOptional bearer token for protected ShapeWords Render API deployments.
SHAPEWORDS_POLL_TIMEOUT_MSdefault: 90000Maximum time to wait for hosted render jobs, in milliseconds.
SHAPEWORDS_REQUEST_TIMEOUT_MSdefault: 30000Per-request timeout for ShapeWords API calls, in milliseconds.
Readme
ShapeWords MCP
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.
Tools
All tools use stdio MCP transport.
render_word_cloud
Creates a ShapeWords render job, polls until it is finished, and returns:
- public artifact URL for hosted renders, or a local inline artifact for
engine: "skia"; - job metadata;
- optional image content for MCP clients that support image results.
Use this tool for one-shot generation when the caller wants the final artifact.
create_word_cloud_job
Starts 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_job
Checks a render job by ID.
Details
- Repository
- github.com/kirrrr-2423/shapewords-mcp
- Website
- shapewords.fun
- Categories
- Design & Creative, Data & Analytics, Productivity & Office
- Package
shapewords-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Design & Creative MCP servers
View all
Rosh Mcprosh-studio/rosh-mcpCreate interactive web apps, games, and 3D scenes using Rosh — a plain-English language0stars
Time's up Skybridge example Apptech.skybridge.times-up/time-s-upSkybridge Example App showcasing a Time's up game with the LLM0stars
Mcpsalexashenko/dreamtapDreamtap provides sources of inspiration to your AI to make it more creative.0stars
Next AI Draw.iodayuanjiang/next-ai-draw-iodraw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand36.9Kstars
Dembrandtdembrandt/dembrandtDesign tokens from any live site: colours, type, spacing, components, drift against a baseline.4Kstars
emailmdanypost/emailmdRender markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.1.4Kstars