> ## Documentation Index
> Fetch the complete documentation index at: https://docs.svgverseai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> The SVGverseAI MCP Server gives developers direct access to AI-powered tools for image generation, vector conversion, and collection management. 

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](https://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.

| 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**](mailto:hello@svgverseai.com)