# Gradient Generator — MCP tool `findutils:gradient_generator`

Generate a CSS linear, radial, or conic gradient from colour stops (2 to 10) and an angle, or from a preset (sunset, ocean, forest, fire, purple, cool). Returns the "background: ...;" rule, the bare gradient value, and the sorted colour stops.

- Category: generators
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/gradient-generator/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/mcp/gradient-generator/
- Same tool on the other surface: https://findutils.com/api/gradient-generator/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "gradient_generator",
      "arguments": {
        "type": "linear",
        "angle": 90,
        "color_stops": [
          {
            "color": "#667eea",
            "position": 0
          },
          {
            "color": "#764ba2",
            "position": 100
          }
        ]
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `type` | string (linear \| radial \| conic) | no | Gradient type. Default: `"linear"`. |
| `angle` | number | no | Angle in degrees (0-360) for linear and conic gradients. Default 90. Default: `90`. |
| `color_stops` | array | no | Colour stops, 2 to 10 items: { color: "#rrggbb", position: 0-100 }. Default: #667eea at 0%, #764ba2 at 100%. |
| `preset` | string (sunset \| ocean \| forest \| fire \| purple \| cool) | no | Use a preset palette instead of color_stops (evenly spaced stops). |
| `radial_shape` | string (circle \| ellipse) | no | Radial only: shape. Default: `"circle"`. |
| `radial_position` | string | no | Radial only: position keyword or lengths, e.g. "center", "top left", "50% 50%". Default "center". Default: `"center"`. |

Example arguments (verified):

```json
{
  "type": "linear",
  "angle": 90,
  "color_stops": [
    {
      "color": "#667eea",
      "position": 0
    },
    {
      "color": "#764ba2",
      "position": 100
    }
  ]
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/gradient-generator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "type": "linear",
    "angle": 90,
    "color_stops": [
      {
        "color": "#667eea",
        "position": 0
      },
      {
        "color": "#764ba2",
        "position": 100
      }
    ]
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/gradient-generator
```

Full REST reference: https://findutils.com/api/gradient-generator/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt