[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Color Tint](https://spiral.ai/integrations/cursor/color-tint)

# How to Use Color Tint in Cursor

Color Tint applies a color effect to an existing image, making it useful for photo styling and comparing visual directions. Choose it for a tinting pass, with adjustable strength to test how much color treatment the image needs.

|  |  |
| --- | --- |
| Model | Color Tint |
| Available through | fal |
| Category | Image |
| Price | $0.0013 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Color Tint in Cursor

- Use Color Tint on the project's homepage photo with a warm treatment at strength 0.3. Save a separate copy and show it beside the original in the local preview.
- Use Color Tint to create sepia treatments at strengths 0.2 and 0.5 from the project's event photo. Build a comparison view with the original and both results.
- Use Color Tint on the project's podcast cover image with a teal treatment at strength 0.4. Show the result in the existing cover layout so I can review it with the title.
- Use Color Tint to apply a cool treatment at strength 0.25 to the project's editorial photos. Save separate outputs and report each returned image's dimensions.
- Use Color Tint on the project's campaign photo to compare warm and cool treatments, both at strength 0.3. Add a preview where I can inspect each beside the original.

## How to set up Color Tint 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 Color Tint**: 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/post-processing/color-tint",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/web-examples/post-process/postpro-input.jpg"
    }
  }'
```

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

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

## Color Tint tools and prices

- [Post Processing Color Tint](https://spiral.ai/tools/fal/fal-ai/post-processing/color-tint) (fal): $0.0013 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tint_strength | 0.1 to 1 | 1 | Tint strength |
| tint_mode | sepia, red, green, blue, cyan, magenta, yellow, purple, orange, warm, cool, lime, navy, vintage, rose, teal, maroon, peach, lavender, olive | sepia | Tint color mode |

## What can you do with Color Tint in Cursor?

Create tinted image candidates for your project's pages and compare them in context. A coding agent can work from project assets, prepare the treatments, and place the results in a preview for review.

### Editorial photo treatments

Try a warm tint on a feature photo, then compare it with the original before choosing the treatment for publication.

### Retro event artwork

Apply a sepia treatment to an existing event photo for a history talk, anniversary announcement, or reunion invitation.

### Campaign color studies

Test different tint treatments on the same campaign image so a designer can choose a color direction before final production.

### Social post styling

Compare two tint strengths on a social post image. Review the photo and any existing lettering before selecting the final version.

### Presentation imagery

Apply a chosen tint to existing presentation photos, then review them together for a suitable visual treatment.

### Cover art exploration

Try a cool or teal treatment on an existing podcast or playlist cover image before adding final typography.

## Overview

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

## Color Tint in other agents

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

## More Cursor guides

- [CodeFormer](https://spiral.ai/integrations/cursor/codeformer)
- [Crystal Upscaler](https://spiral.ai/integrations/cursor/crystal-upscaler)
- [Clarity Upscaler](https://spiral.ai/integrations/cursor/clarity-upscaler)
- [DDColor](https://spiral.ai/integrations/cursor/ddcolor)
- [City Teleport](https://spiral.ai/integrations/cursor/city-teleport)
- [Dissolve](https://spiral.ai/integrations/cursor/dissolve)

## Questions about Color Tint in Cursor

**Can Cursor use Color Tint?**

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

**How much does Color Tint cost in Cursor?**

$0.0013 per image. 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 Color Tint in Cursor?**

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

**How long does it take to set up Color Tint in Cursor?**

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

**Does Cursor wait while Color Tint runs?**

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

**What is Color Tint useful for?**

Use it to explore color treatments on an existing image. Practical starting points include editorial photos, social graphics, and campaign artwork.

**How should I describe a Color Tint task?**

Identify the image, name the color treatment, and specify its strength. Ask your agent to compare results against the original instead of writing a long scene description.

**How do I choose the right tint strength?**

Keep the image and treatment fixed, then compare two strengths side by side. For a first comparison, try 0.2 and 0.5, then refine from the result you prefer.

**Should I use Color Tint when accurate colors matter?**

Keep an untinted reference and review the result before using it for product listings or other work that depends on accurate colors. Treat tinting as a styling decision, and check skin tones, packaging, and brand colors before approving it.

**What resolution does Color Tint return?**

The maker documents output width and height in pixels, but publishes no maximum resolution or guarantee that dimensions stay unchanged. Check the returned image dimensions before using the result in a fixed-size layout.

