# SVGMaker MCP - Generate Tool

Generates SVG images from text prompts using the SVGMaker API.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt` | string | Yes | Text description of the SVG to generate |
| `output_path` | string | Yes | Local file path where the SVG will be saved (must end with .svg) |
| `quality` | "low" \| "medium" \| "high" | No | Quality level affecting aspect ratio. low/medium use 'auto', high uses 'square' by default |
| `aspectRatio` | "square" \| "portrait" \| "landscape" | No | Override the default aspect ratio |
| `background` | "auto" \| "transparent" \| "opaque" | No | Background type for the generated SVG |

## Progress Notifications

The tool sends progress updates every 5 seconds:

1. Start (0%):
   ```
   "Starting SVG generation..." (0%)
   ```

2. Processing (25%, 50%, 75%):
   ```
   "Generating SVG... 25%"
   "Generating SVG... 50%"
   "Generating SVG... 75%"
   ```

3. Completion (100%):
   ```
   "SVG generation complete!" (100%)
   ```

## Examples

### Basic Generation
```json
{
  "prompt": "A simple blue circle with a red border",
  "output_path": "./circle.svg"
}
```

### High Quality with Square Aspect Ratio
```json
{
  "prompt": "A detailed mountain landscape with sun",
  "output_path": "./landscape.svg",
  "quality": "high",
  "aspectRatio": "square"
}
```

### With Custom Background
```json
{
  "prompt": "A minimalist logo design",
  "output_path": "./logo.svg",
  "quality": "high",
  "background": "transparent"
}
```

## Response

On success:
```json
{
  "content": [
    {
      "type": "text",
      "text": "SVG generated successfully: /path/to/output.svg"
    }
  ]
}
```

On error:
```json
{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Error generating SVG: [error message]"
    }
  ]
}
```

## Error Handling

Common errors:
- Invalid file paths
- Missing permissions
- API rate limits
- Network issues
- Invalid SVG content

Each error returns a descriptive message to help diagnose the issue.