Skip to main content
Glama
deenesjakoruzh
syntropicsignal-ai

Quiver-MCP

by syntropicsignal-ai
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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/.

Related MCP server: nakkas

Requirements

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

Available Tools

3 tools
generate_svgA

Generate one or more SVGs from a text prompt using QuiverAI. Returns raw SVG markup.

Prompt guide

A good prompt has three parts: subject (specific object), style (aesthetic keywords), and color palette (hex codes if possible).

What works

  • Use concrete, famous physical objects the model has seen (AirPods, Nike Dunks, Shure SM7B, Montblanc pen, Leica camera, Nest thermostat, espresso machines). Cylindrical/round objects explode especially cleanly in isometric style.

  • Name the style explicitly: 'line art', 'hand drawn', 'duotone', 'flat monochrome icon', 'geometric', 'minimalist', 'isometric', 'blueprint'.

  • Specify colors with hex codes: 'background: #e9edc9 and logo in #fb8500'.

  • Add composition framing: 'centered icon', 'wide horizontal logo'.

  • Prompt modifiers: 'geometric' → angular shapes, 'detailed' → more elements, 'simple' → clearer shapes, 'minimalist' → fewer details, 'flat monochrome' → single-color, 'duotone' → two-color.

What does NOT work

  • NEVER mention 'AI', 'machine learning', 'voice assistant', 'workflow automation', or abstract software concepts — produces garbage. Use physical metaphors instead (microphone for voice, watch movement for precision).

  • Abstract concepts without physical objects: 'knowledge graph', 'automation pipeline', 'data flow'.

  • Obscure B2B hardware the model hasn't seen (e.g. Loxone Miniserver → generic blob).

  • 'minimalist line icon' constraints — model ignores them and fills with color.

Iteration strategy

Start specific, not vague. Bad: 'Tech logo'. Better: 'Tech startup logo with geometric shapes, blue gradient'. Best: 'SaaS productivity logo with connected geometric nodes, electric blue to purple gradient, clean modern style'.

Verified template

exploded isometric view of a {FAMOUS_OBJECT}, technical blueprint drawing, thin line art, dotted grid background, labeled components, engineering illustration

Known issues

  • ~1 in 10 generations have corrupted SVG tails (malformed XML). Generate 3+ variants as insurance.

  • Model may ignore 'no fills'/'monochrome' and hardcode its own palette. Post-process with find/replace for brand colors.

  • First call may 504 — retry succeeds.

ParametersJSON Schema
NameRequiredDescriptionDefault
promptYesWHAT to generate. Be specific: name a concrete famous object, add style keywords, and specify colors with hex codes. Example: 'Heraldic lion crest with ornate medieval style details and gold gradient accents'. Never use abstract concepts like 'AI agent' or 'workflow' — use physical metaphors instead.
modelYesModel ID to use. Recommended: 'arrow-preview' (Arrow 1.0, #1 on SVG Arena). Use list_models to discover all options.
instructionsNoHOW it should look — style guidance separate from the subject. Think of prompt as 'what' and instructions as 'how'. Example: prompt='Japanese crane', instructions='Use a warm muted palette with detailed feather work'.
nNoNumber of SVG variants to generate (max 16). Recommended: 3+ at higher temperature for best results, since ~1 in 10 generations can have corrupted tails.
temperatureNoSampling temperature (0–2). Lower (0.4) = more consistent, higher (0.9) = more creative variation. Use 0.9 with n≥3 for exploration.
referencesNoUp to 4 reference images for style, color, and composition guidance. References pull palette/color hints from the image, but style keywords ('blueprint', 'isometric', 'flat') must still be in the text prompt — references alone won't change drawing style.
outputPathNoOptional absolute file path to save the SVG(s) to disk. If omitted, SVG markup is returned in the response only. For multiple variants (n > 1), files are saved with _1, _2 … suffixes. Parent directories are created automatically.

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully covers behavioral traits: it mentions return format (raw SVG markup), corruption rate (~1 in 10), timeout behavior (504 with retry), and model's tendency to ignore palette constraints. This gives the agent a clear understanding of tool behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but well-structured with clear headings and sections. It front-loads the core purpose and then provides detailed guidance. While verbose, every section serves a purpose; however, some redundancy could be trimmed for brevity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (7 parameters, no output schema, no annotations), the description is remarkably complete. It covers prompt crafting, iteration strategies, known issues, and error recovery. The 'Prompt guide' alone provides rich context that an agent needs to succeed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Although schema description coverage is 100%, the description adds substantial value beyond schema. The 'Prompt guide' provides concrete examples, do's and don'ts, and detailed reasoning for parameters like n and temperature. It also explains how references work and their limitations, which the schema does not fully convey.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Generate one or more SVGs from a text prompt using QuiverAI. Returns raw SVG markup.' It specifies the verb (generate), resource (SVGs), and distinguishes from sibling tools like list_models and vectorize_svg.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides extensive guidelines on when and how to use, including prompt structure, what works, what does not work, iteration strategy, and a verified template. It also covers known issues like corrupted tails and 504 errors, giving failure recovery guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_modelsA

List all models available on QuiverAI, including supported operations (svg_generate, svg_vectorize, etc.) and pricing.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations, but description is straightforward (list only). Does not mention read-only nature or auth requirements, but these are implicit for a list operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, no wasted words, front-loaded with purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Complete for a simple list tool with no parameters and no output schema. Describes what is included (operations, pricing). Could mention output format but not critical.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters in schema; baseline for 0 params is 4. Description adds no param info (none needed).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states verb (List), resource (models), and includes what info is returned (supported operations and pricing). Distinguishes from siblings generate_svg and vectorize_svg which are different actions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implied usage: use to discover available models before generating or vectorizing. No explicit when-not-to-use or alternatives, but context makes it clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

vectorize_svgA

Convert a raster image (PNG, JPG, etc.) into an SVG using QuiverAI. Provide the image as a URL or base64-encoded string.

ParametersJSON Schema
NameRequiredDescriptionDefault
modelYesModel ID to use. Use list_models to find models that support svg_vectorize.
imageYesThe image to vectorize — either a URL or base64 data.
autoCropNoAuto-crop to the dominant subject before vectorizing. Defaults to false.
targetSizeNoSquare resize target in pixels before vectorizing.
temperatureNoSampling temperature (0–2). Defaults to 1.
outputPathNoOptional absolute file path to save the vectorized SVG to disk. If omitted, SVG markup is returned in the response only. Parent directories are created automatically.

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations, so description carries full burden; it lacks details on failure modes, rate limits, output quality, or side effects beyond basic conversion.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with purpose, no extraneous information—efficient and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers basic purpose and input method but omits return value format, side effects of optional parameters, and behavioral traits; adequate given schema coverage but incomplete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with detailed parameter descriptions, so description adds no new semantics beyond mentioning input image formats; baseline score applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool converts raster images (PNG, JPG) to SVG using QuiverAI, distinguishing it from sibling generate_svg which likely creates SVGs from scratch.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implies usage when a raster image needs conversion, but no explicit guidance on when not to use or alternatives like generate_svg or list_models.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 3 tool updatesv0.1.0
    • First observedgenerate_svg
    • First observedlist_models
    • First observedvectorize_svg
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a distinct purpose: generating SVGs from prompts, listing models, and vectorizing images. There is no overlap.

Naming Consistency5/5

All tool names follow consistent snake_case with verb_noun pattern (generate_svg, list_models, vectorize_svg).

Tool Count4/5

Three tools is on the low side but reasonable for a focused server. The scope is narrow enough that each tool earns its place.

Completeness3/5

Core SVG creation (from text and images) and model listing are covered, but missing operations like fetching/updating/deleting individual SVGs or batch processing.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers