[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Clarity Upscaler](https://spiral.ai/integrations/cursor/clarity-upscaler)

# How to Use Clarity Upscaler in Cursor

Clarity Upscaler enlarges existing images with detail you can steer through a descriptive prompt. Adjust creativity and resemblance to balance new texture against keeping the original appearance.

|  |  |
| --- | --- |
| Model | Clarity Upscaler |
| Available through | fal |
| Category | Image |
| Price | Up to $0.039 per run at the default inputs. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Clarity Upscaler in Cursor

- Use Clarity Upscaler to enlarge the homepage illustration in this project 2x. Describe its existing subject and style, use low creativity and high resemblance, and save a separate output for review.
- Use Clarity Upscaler on the landscape artwork in the project's image assets. Make two 2x enlargements with the same seed: one with low creativity and one with moderate creativity. Build a side-by-side preview.
- Use Clarity Upscaler to make a 2x enlargement of the product mockup used on the landing page. Describe its materials and lighting, favor resemblance, and keep the current asset until I review the result.
- Use Clarity Upscaler on the character concept image in this project. Enlarge it 2x with a prompt describing the visible costume materials, then prepare close-up comparisons of the face and clothing.
- Use Clarity Upscaler to enlarge the article illustration in this repository 2x. Keep the source and prompt fixed while testing two resemblance settings, and show both results beside the original.

## How to set up Clarity Upscaler in Cursor

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Clarity Upscaler**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/clarity-upscaler",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/gallery/NOCA_Mick-Thompson.resized.resized.jpg"
    }
  }'
```

Then paste one of the prompts above: Cursor finds Clarity Upscaler on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## Clarity Upscaler tools and prices

- [Clarity Upscaler](https://spiral.ai/tools/fal/fal-ai/clarity-upscaler) (fal): Up to $0.039 per run at the default inputs.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| prompt |  | masterpiece, best quality, highres | The prompt to use for generating the image. Be as descriptive as possible for best results. |
| upscale_factor | 1 to 4 | 2 | The upscale factor |
| negative_prompt |  | (worst quality, low quality, normal quality:2) | The negative prompt to use. Use it to address details that you don't want in the image. |
| creativity | 0 to 1 | 0.35 | The creativity of the model. The higher the creativity, the more the model will deviate from the prompt. Refers to the denoise strength of the sampling. |
| resemblance | 0 to 1 | 0.6 | The resemblance of the upscaled image to the original image. The higher the resemblance, the more the model will try to keep the original image. Refers to the strength of the ControlNet. |
| guidance_scale | 0 to 20 | 4 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |

## What can you do with Clarity Upscaler in Cursor?

Turn existing project artwork into larger images for websites and apps with Clarity Upscaler. Your coding agent can prepare comparisons and keep the originals available for review.

### Website artwork

Enlarge an existing website illustration for a larger placement. Describe its current style and review the result against the original before replacing it.

### Editorial illustrations

Prepare a larger version of an illustration for an article or newsletter. Describe the drawing medium, palette, and texture in the prompt.

### Landscape artwork

Enlarge landscape art while exploring detail in rocks, foliage, or clouds. Compare a restrained pass with a more creative pass before choosing.

### Concept art review

Make a larger concept image for reviewing costume materials, buildings, or scenery. Treat added texture as a proposed interpretation and check it against the design brief.

### Portrait enlargement trials

Test a larger portrait with low creativity and high resemblance. Review the face against the source before accepting the result.

### Product mockup presentations

Enlarge an existing product mockup for a presentation. Describe its materials and lighting, then inspect shapes and markings for unwanted changes.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## Clarity Upscaler in other agents

- [Amp](https://spiral.ai/integrations/amp/clarity-upscaler)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/clarity-upscaler)
- [Claude](https://spiral.ai/integrations/claude-desktop/clarity-upscaler)
- [Claude Code](https://spiral.ai/integrations/claude-code/clarity-upscaler)
- [Cline](https://spiral.ai/integrations/cline/clarity-upscaler)
- [Codex](https://spiral.ai/integrations/codex/clarity-upscaler)
- [Devin](https://spiral.ai/integrations/devin/clarity-upscaler)
- [dots](https://spiral.ai/integrations/dots/clarity-upscaler)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/clarity-upscaler)
- [Gemini](https://spiral.ai/integrations/gemini/clarity-upscaler)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/clarity-upscaler)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/clarity-upscaler)
- [goose](https://spiral.ai/integrations/goose/clarity-upscaler)
- [Grok](https://spiral.ai/integrations/grok/clarity-upscaler)
- [Grok Build](https://spiral.ai/integrations/grok-build/clarity-upscaler)
- [Hermes](https://spiral.ai/integrations/hermes/clarity-upscaler)
- [Instinct](https://spiral.ai/integrations/instinct/clarity-upscaler)
- [Manus](https://spiral.ai/integrations/manus/clarity-upscaler)
- [Muse](https://spiral.ai/integrations/muse/clarity-upscaler)
- [Muse Code](https://spiral.ai/integrations/muse-code/clarity-upscaler)
- [n8n](https://spiral.ai/integrations/n8n/clarity-upscaler)
- [Notion](https://spiral.ai/integrations/notion/clarity-upscaler)
- [OpenClaw](https://spiral.ai/integrations/openclaw/clarity-upscaler)
- [opencode](https://spiral.ai/integrations/opencode/clarity-upscaler)
- [Perplexity](https://spiral.ai/integrations/perplexity/clarity-upscaler)
- [Raycast](https://spiral.ai/integrations/raycast/clarity-upscaler)
- [VS Code](https://spiral.ai/integrations/vscode/clarity-upscaler)
- [Windsurf](https://spiral.ai/integrations/windsurf/clarity-upscaler)
- [Zapier](https://spiral.ai/integrations/zapier/clarity-upscaler)

## More Cursor guides

- [City Teleport](https://spiral.ai/integrations/cursor/city-teleport)
- [CodeFormer](https://spiral.ai/integrations/cursor/codeformer)
- [Chromatic Aberration](https://spiral.ai/integrations/cursor/chromatic-aberration)
- [Color Tint](https://spiral.ai/integrations/cursor/color-tint)
- [Cartoonify](https://spiral.ai/integrations/cursor/cartoonify)
- [Crystal Upscaler](https://spiral.ai/integrations/cursor/crystal-upscaler)

## Questions about Clarity Upscaler in Cursor

**Can Cursor use Clarity Upscaler?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Clarity Upscaler like any built-in tool.

**How much does Clarity Upscaler cost in Cursor?**

Up to $0.039 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

**Do I need a fal account to use Clarity Upscaler in Cursor?**

No. Spiral runs Clarity Upscaler on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Clarity Upscaler in Cursor?**

About two minutes: add the hosted server, then sign in.

**Does Cursor wait while Clarity Upscaler runs?**

Clarity Upscaler runs in the background. Cursor starts the run, checks on it and gives you the image when it's ready.

**What is Clarity Upscaler useful for?**

Use it to enlarge an existing image while guiding its detail with a prompt. It is useful when you want control over how much the result reinterprets the source.

**Will Clarity Upscaler change my image?**

It can invent detail, especially at higher creativity. Start with low creativity and high resemblance when preserving the original appearance matters, then compare the result closely.

**What should I put in the prompt?**

Describe the subject, materials, lighting, and visual style you want retained or refined. For example: 'Ceramic bowl, matte blue glaze, subtle surface texture, soft window light.'

**How do I work out the output dimensions?**

Multiply the source width and height by the enlargement factor. For example, a 1024 × 1024 image enlarged 2x targets 2048 × 2048 pixels.

**How can I repeat a result?**

Keep the source image, prompt, seed, settings, and model version unchanged. When comparing settings, hold the seed steady and change one setting at a time.

