quiver-mcp

MCP server for QuiverAI — generate SVGs from text prompts and vectorize raster images using AI, directly from Claude (or any MCP-compatible client).

Examples

Generated by Claude calling this MCP. Each took ~60s at n: 3, temperature: 0.9. Both prompts are documented in the tool description, so Claude knows the recipe.

Prompt: exploded isometric view of a Montblanc Meisterstück fountain pen, technical blueprint drawing, thin line art, dotted grid background, labeled components, engineering illustration

Prompt: Japanese crane in traditional woodblock illustration style with warm earth tones
Instructions: Use a warm muted palette with detailed feather work

More variants in examples/.

Requirements

• Node.js 18+
• A QuiverAI API key

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "quiverai": {
      "command": "npx",
      "args": ["-y", "@syntropic/quiver-mcp"],
      "env": {
        "QUIVERAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Manual

npm install -g @syntropic/quiver-mcp
QUIVERAI_API_KEY=your_api_key_here quiver-mcp

Tools

generate_svg

Generate one or more SVGs from a text prompt.

| Parameter | Type | Required | Description | |---|---|---|---| | prompt | string | yes | Text description of the SVG to generate | | model | string | yes | Model ID (use list_models to discover options) | | instructions | string | no | Additional style or formatting guidance | | n | number | no | Number of SVGs to generate (default: 1) | | temperature | number | no | Sampling temperature 0–2 (default: 1) | | references | array | no | Up to 4 image references ({url} or {base64}) for palette and composition guidance. Style keywords must still be in the prompt text. | | outputPath | string | no | Absolute file path to save SVG(s) to disk. For multiple variants (n > 1), files are saved with _1, _2 … suffixes. Parent directories are created automatically. |

Prompt tips

The tool description includes extensive prompt guidance, but in short:

• Structure prompts with three parts: subject (concrete object), style (aesthetic keywords like line art, isometric, flat monochrome), and color palette (hex codes where possible).
• Use famous physical objects the model knows. Avoid abstract software concepts (AI agent, workflow) — use physical metaphors instead.
• For exploration, generate 3+ variants at temperature: 0.9. Some generations produce corrupted tails; extra variants give you options.

vectorize_svg

Convert a raster image (PNG, JPG, etc.) to SVG.

| Parameter | Type | Required | Description | |---|---|---|---| | model | string | yes | Model ID | | image | object | yes | Image to vectorize — {url} or {base64} | | autoCrop | boolean | no | Crop to dominant subject before vectorizing (default: false) | | targetSize | number | no | Square resize target in pixels before vectorizing | | temperature | number | no | Sampling temperature 0–2 (default: 1) | | outputPath | string | no | Absolute file path to save the SVG to disk. Parent directories are created automatically. |

list_models

List all available QuiverAI models with supported operations and pricing.

Environment Variables

| Variable | Description | |---|---| | QUIVERAI_API_KEY | Required. Your QuiverAI API key |

Development

npm install
npm run build   # compile TypeScript
npm run dev     # watch mode

License

MIT