Setup - Svgverseai Docs

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

Go to app.svgverseai.com/account/api-keys
Open your Profile
Click Generate API Key
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.

Field	Type	Required	Description
`prompt`	string	✅	Text prompt describing the image to generate
`negative_prompt`	string	❌	Words or elements to exclude
`style`	string	✅	Style name from Spark styles
`output_format`	string	✅	Choose `svg` or `png`
`collectionId`	string	❌	Optional collection ID (defaults to user’s main collection)
`isPrivate`	boolean	❌	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.

Field	Type	Required	Description
`prompt`	string	✅	Description of the image to generate
`negative_prompt`	string	❌	Elements to exclude
`style`	string	✅	Style name from Blaze styles
`output_format`	string	✅	`svg`, `png`, or `webp`
`collectionId`	string	❌	Optional target collection ID
`isPrivate`	boolean	❌	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.

Field	Type	Required	Description
`url`	string	✅	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.

Field	Type	Required	Description
`name`	string	✅	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

Tool	Description	Output Formats	Style Support	Requires API Key
`generate-spark-image`	Generate fast images using Spark model	svg, png	✅	✅
`generate-blaze-image`	High-quality image generation	svg, png, webp	✅	✅
`image-to-svg`	Convert raster to vector	svg	❌	✅
`list-collections`	List user collections	json	❌	✅
`create-collection`	Create a new collection	json	❌	✅

Error Codes

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

Support

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

​Authentication

​Getting an API Key

​Server Endpoint

​Example Request

​Available Tools

​1. generate-spark-image

​2. generate-blaze-image

​3. image-to-svg

​4. list-collections

​5. create-collection

​Working with Collections

​Example Response

​MCP Tool Summary

​Error Codes

​Support