Skip to main content
Use the MCP API to:
  • Generate SVG / PNG / WebP images from text prompts
  • Convert existing raster images into scalable vector graphics
  • Organize generated images into collections
  • Control privacy, styles, and output formats — all via one unified API

​
Authentication

All MCP API calls require a valid API Key passed as a query parameter or header. 
x-api-key: YOUR_API_KEY

​
Getting an API Key

  1. Go to app.svgverseai.com/account/api-keys
  2. Open your Profile
  3. Click Generate API Key
  4. Copy and store it securely
⚠️ Important: If your API key is exposed, generate a new one.
The previous key will be automatically revoked for security.

​
Server Endpoint

All MCP tools are accessible via: 
POST https://vista.svgverseai.com/svg/api/v1/mcp
Headers: 
Content-Type: application/json
x-api-key: YOUR_API_KEY

​
Example Request

curl -X POST https://vista.svgverseai.com/svg/api/v1/mcp?x-api-key={YOUR_API_KEY} \
  -H "Content-Type: application/json" \
  -d '{
        "tool": "generate-spark-image",
        "params": {
            "prompt": "A cyberpunk city at night with neon reflections",
            "style": "Illustration",
            "output_format": "png",
            "isPrivate": false
        }
      }'

​
Available Tools

Here are all tools currently supported by the SVGverseAI MCP Server.

​
1. generate-spark-image

Generate SVG or PNG images using Spark Mode — optimized for fast, efficient generations.
FieldTypeRequiredDescription
promptstring✅Text prompt describing the image to generate
negative_promptstring❌Words or elements to exclude
stylestring✅Style name from Spark styles
output_formatstring✅Choose svg or png
collectionIdstring❌Optional collection ID (defaults to user’s main collection)
isPrivateboolean❌Set true to make the image private (not available in Free plan)
💡 Tip:
To find available collection IDs, use the list-collections endpoint.
Example 
{
  "tool": "generate-spark-image",
  "params": {
    "prompt": "A watercolor painting of a peaceful village",
    "style": "Illustration",
    "output_format": "svg",
    "collectionId": "c_123",
    "isPrivate": false
  }
}

​
2. generate-blaze-image

Generate high-quality SVG, PNG, or WebP images using Blaze Mode — ideal for premium visuals and complex detail.
FieldTypeRequiredDescription
promptstring✅Description of the image to generate
negative_promptstring❌Elements to exclude
stylestring✅Style name from Blaze styles
output_formatstring✅svg, png, or webp
collectionIdstring❌Optional target collection ID
isPrivateboolean❌Enable private generation (not available in Free plan)
Default Style: Digital Illustrations(child_book) Example 
{
  "tool": "generate-blaze-image",
  "params": {
    "prompt": "A futuristic spacecraft launching from Mars",
    "style": "Digital Illustrations(child_book)",
    "output_format": "webp",
    "collectionId": "c_200"
  }
}

​
3. image-to-svg

Convert a raster image (JPG, PNG) into a vectorized SVG.
FieldTypeRequiredDescription
urlstring✅URL of the image to convert
Example Request 
{
  "tool": "image-to-svg",
  "params": {
    "url": "https://example.com/input-image.png"
  }
}
Response 
{
  "text": "https://staging-svgverseai-bucket.s3.ap-southeast-1.amazonaws.com/converted-image.svg"
}

​
4. list-collections

Retrieve all collections associated with your API key. Example Request 
{
  "tool": "list-collections"
}
Example Response 
{
  "collections": [
    { "id": "c_001", "name": "Illustrations" },
    { "id": "c_002", "name": "Marketing Graphics" }
  ]
}

​
5. create-collection

Create a new collection to organize generated images.
FieldTypeRequiredDescription
namestring✅Name for your collection
Example 
{
  "tool": "create-collection",
  "params": {
    "name": "Nature Series"
  }
}
Response 
{
  "id": "c_003"
}

​
Working with Collections

Collections make it easy to group your generated assets.
Every user starts with a default collection, but you can create new ones for better project organization.
  • Use list-collections to view all collections
  • Use the returned id in any image generation request
  • If no collectionId is specified, results go to your default collection

​
Example Response

{
  "text": "https://staging-svgverseai-bucket.s3.ap-southeast-1.amazonaws.com/spark_678.png"
}

​
MCP Tool Summary

ToolDescriptionOutput FormatsStyle SupportRequires API Key
generate-spark-imageGenerate fast images using Spark modelsvg, png✅✅
generate-blaze-imageHigh-quality image generationsvg, png, webp✅✅
image-to-svgConvert raster to vectorsvg❌✅
list-collectionsList user collectionsjson❌✅
create-collectionCreate a new collectionjson❌✅

​
Error Codes

CodeMeaning
400Missing or invalid parameters
401Invalid or missing API key
404Tool not found
500Internal server error

​
Support

If you encounter any issues or need help with MCP integrations, contact us at
hello@svgverseai.com
⌘I