ShapeWords MCP Server

by kirrrr-2423io.github.kirrrr-2423/shapewords-mcpv0.2.2

Generate ShapeWords word clouds as SVG, PNG, or JSON from text or weighted words.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install ShapeWords MCP server

claude mcp add shapewords -e SHAPEWORDS_RENDER_API_KEY='<shapewords-render-api-key>' -- npx -y shapewords-mcp

{
  "mcpServers": {
    "shapewords": {
      "command": "npx",
      "args": [
        "-y",
        "shapewords-mcp"
      ],
      "env": {
        "SHAPEWORDS_RENDER_API_KEY": "<shapewords-render-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "shapewords": {
      "command": "npx",
      "args": [
        "-y",
        "shapewords-mcp"
      ],
      "env": {
        "SHAPEWORDS_RENDER_API_KEY": "<shapewords-render-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "shapewords": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "shapewords-mcp"
      ],
      "env": {
        "SHAPEWORDS_RENDER_API_KEY": "<shapewords-render-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "shapewords": {
      "command": "npx",
      "args": [
        "-y",
        "shapewords-mcp"
      ],
      "env": {
        "SHAPEWORDS_RENDER_API_KEY": "<shapewords-render-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
SHAPEWORDS_API_BASE_URL	—	—	ShapeWords Render API base URL. Defaults to the public ShapeWords service.
SHAPEWORDS_RENDER_API_KEY	—	yes	Optional bearer token for protected ShapeWords Render API deployments.
SHAPEWORDS_POLL_TIMEOUT_MS	—	—	Maximum time to wait for hosted render jobs, in milliseconds.
SHAPEWORDS_REQUEST_TIMEOUT_MS	—	—	Per-request timeout for ShapeWords API calls, in milliseconds.

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-06-05 · 4mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-05 · 4mo ago · official registry · v0.2.2

FAQ

›How do I install the ShapeWords MCP server in Claude Code?

Run: claude mcp add shapewords -e SHAPEWORDS_RENDER_API_KEY='<shapewords-render-api-key>' -- npx -y shapewords-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does ShapeWords require an API key?

Yes. It expects SHAPEWORDS_RENDER_API_KEY, of which 1 is a secret.

›Can I use ShapeWords as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is ShapeWords in the official MCP registry?

Yes, as io.github.kirrrr-2423/shapewords-mcp.