speis-mcp

MCP server that builds and audits UI code — no AI slop.

Setup — Claude Code / Claude Desktop

Add to your MCP config:

{
  "mcpServers": {
    "speis": {
      "command": "npx",
      "args": ["-y", "speis-mcp@latest"],
      "env": { "SPEIS_API_KEY": "your_key_here" }
    }
  }
}

Restart Claude, then verify:

Call speis_ping

Expected:

{ "status": "ok", "version": "0.1.0" }

Setup — Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "speis": {
      "command": "npx",
      "args": ["-y", "speis-mcp@latest"],
      "env": { "SPEIS_API_KEY": "your_key_here" }
    }
  }
}

Tools

| Tool | Description | Plan | | --------------------------- | -------------------------------------------------------- | ---- | | speis_ping | Health check | Free | | speis_build | Generate a full landing page from an intent description | Pro | | speis_verify | Audit UI code for typography, color, spacing and UX debt | Free | | speis_principles | Look up relevant design principles for a task | Pro | | suggest_image | Find stock photos matching a visual intent | Pro | | suggest_graphical_details | Generate SVG ornaments, dividers, and patterns | Pro |

Environment variables

| Variable | Required | Description | | ---------------- | -------- | ----------------------------------------------- | | SPEIS_API_KEY | Yes | Your SPEIS API key (sk_speis_...) | | SPEIS_PROXY_URL| No | Override proxy URL (must be HTTPS, dev/self-host only) |

Development

npm install
npm run build
npm start