[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [UI-TARS 1.5 7B](https://spiral.ai/integrations/cursor/ui-tars-1-5-7b)

# How to Use UI-TARS 1.5 7B in Cursor

UI-TARS 1.5 7B turns screenshots and task instructions into mouse and keyboard actions for computer workflows. Unlike the higher-performing UI-TARS 1.5 research model, it focuses on general computer use and is not optimized for games.

|  |  |
| --- | --- |
| Model | UI-TARS 1.5 7B |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.000539 per run at the default inputs. $0.13 per 1M input tokens, $0.26 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with UI-TARS 1.5 7B in Cursor

- Use UI-TARS 1.5 7B to test this project's search page. Read the expected behavior in the repository, then use browser screenshots to search for headphones and select the in-stock filter, requesting one action at a time.
- Use UI-TARS 1.5 7B on the failing checkout screenshot in this project. Locate the Continue button and return only the click action; mark the predicted point on the screenshot for review.
- Use UI-TARS 1.5 7B to exercise this project's profile editor with the test data in the repository. Fill the visible fields, stop before saving, and capture the resulting screen.
- Use UI-TARS 1.5 7B to reproduce the navigation bug described in this project's issue notes. Supply the current screenshot and action history at each step, and record where the visible result first differs from the expected behavior.
- Use UI-TARS 1.5 7B to check this project's settings flow. Start with temperature 0 and a 400-token output budget, request Thought and Action sections, and navigate to notification preferences one action at a time.

## How to set up UI-TARS 1.5 7B 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 UI-TARS 1.5 7B**: 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": "openrouter",
    "model": "bytedance/ui-tars-1.5-7b",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Cursor finds UI-TARS 1.5 7B on Spiral, shows the price and runs it.

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

## UI-TARS 1.5 7B tools and prices

- [ByteDance: UI-TARS 7B ](https://spiral.ai/tools/openrouter/bytedance/ui-tars-1.5-7b) (OpenRouter): Up to $0.000539 per run at the default inputs. $0.13 per 1M input tokens, $0.26 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| stop |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |
| logprobs |  | — |  |
| max_tokens | 1 to 2048 | — | The most output tokens to generate. |

## What can you do with UI-TARS 1.5 7B in Cursor?

UI-TARS 1.5 7B can help test a project's interface through screenshots and mouse or keyboard actions. Give it a concrete workflow and inspect the visible result after each step.

### Find a control in a screenshot

Ask UI-TARS 1.5 7B to locate a named button or menu item and return only the next click action.

### Test a browser workflow

Use screenshots and action history to work through a search, filter, or form flow. Check the screen after each action against the expected result.

### Navigate desktop settings

Give UI-TARS 1.5 7B a specific destination, such as a display settings panel, and request the next mouse or keyboard action.

### Prepare a form draft

Supply the visible form and exact text to enter. Request actions to fill the fields and stop before submission.

### Work through an office interface

Use visible menus, clicks, typing, and keyboard shortcuts to guide a bounded task in a spreadsheet or document editor.

### Navigate a file manager

Provide a screenshot and a target folder name. Request the next action to reach that folder, with a new screenshot after navigation.

## Overview

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

## UI-TARS 1.5 7B in other agents

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

## More Cursor guides

- [Ternary Bonsai 2 9B](https://spiral.ai/integrations/cursor/ternary-bonsai-2-9b)
- [UnslopNemo 12B](https://spiral.ai/integrations/cursor/unslopnemo-12b)
- [Ternary Bonsai 2 27B](https://spiral.ai/integrations/cursor/ternary-bonsai-2-27b)
- [Venice Uncensored](https://spiral.ai/integrations/cursor/venice-uncensored)
- [Step 5 Preview](https://spiral.ai/integrations/cursor/step-5-preview)
- [Voxtral Small 24B](https://spiral.ai/integrations/cursor/voxtral-small-24b)

## Questions about UI-TARS 1.5 7B in Cursor

**Can Cursor use UI-TARS 1.5 7B?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run UI-TARS 1.5 7B like any built-in tool.

**How much does UI-TARS 1.5 7B cost in Cursor?**

Up to $0.000539 per run at the default inputs. $0.13 per 1M input tokens, $0.26 per 1M output tokens. 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 an OpenRouter account to use UI-TARS 1.5 7B in Cursor?**

No. Spiral runs UI-TARS 1.5 7B on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up UI-TARS 1.5 7B in Cursor?**

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

**Does Cursor wait while UI-TARS 1.5 7B runs?**

UI-TARS 1.5 7B runs in the background. Cursor starts the run, checks on it and gives you the text, json when it's ready.

**What is UI-TARS 1.5 7B useful for?**

It is designed for computer tasks that involve reading a screen and choosing mouse or keyboard actions. Practical uses include navigating forms, finding controls, and working through desktop interfaces.

**What does UI-TARS 1.5 7B return?**

The documented computer-use format has Thought and Action sections. For locating a target on screen, the grounding prompt requests an action alone.

**What should I include in a UI-TARS 1.5 7B prompt?**

Supply the task, a current screenshot, and the preceding action history. Ask for the next action toward a concrete result, such as opening a particular settings panel.

**Is UI-TARS 1.5 7B optimized for games?**

ByteDance says the released 7B model focuses on general computer use and is not specifically optimized for games. The stronger game results described for UI-TARS 1.5 should not be attributed to the 7B model.

**Which generation settings are a useful starting point?**

ByteDance's example uses temperature 0 and a 400-token output budget. Treat those as starting values for short action responses, rather than a statement of the model's maximum output length.

