[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Sonar Reasoning Pro](https://spiral.ai/integrations/windsurf/sonar-reasoning-pro)

# How to Use Sonar Reasoning Pro in Windsurf

Sonar Reasoning Pro combines web research with reasoning for questions that need evidence from several sources. Compared with Sonar Reasoning, it searches more sources and applies more deliberation.

|  |  |
| --- | --- |
| Model | Sonar Reasoning Pro |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.04919 per run at the default inputs. $2.60 per 1M input tokens, $10.40 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Sonar Reasoning Pro in Windsurf

- Read package.json and the lockfile, then use Sonar Reasoning Pro to research migration guidance for the next major version of our web framework. Produce a cited checklist of breaking changes and map each relevant change to our code.
- Read our architecture notes, then use Sonar Reasoning Pro to compare PostgreSQL full-text search with OpenSearch for our documented requirements. Cite official documentation, explain tradeoffs, and list the assumptions we should test.
- Inspect our authentication implementation, then use Sonar Reasoning Pro to research the relevant OAuth security guidance. Return a cited gap analysis and proposed changes for review.
- Read our README and use Sonar Reasoning Pro to verify its claims about browser support against current official documentation. List each claim, supporting evidence, and any wording that needs correction.
- Inspect our deployment configuration, then use Sonar Reasoning Pro to research documented graceful shutdown behavior for our runtime and hosting platform. Draft a recommendation with citations and identify checks we should run locally.

## How to set up Sonar Reasoning Pro in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

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

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 Sonar Reasoning Pro**: 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": "perplexity/sonar-reasoning-pro",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Sonar Reasoning Pro on Spiral, shows the price and runs it.

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

## Sonar Reasoning Pro tools and prices

- [Perplexity: Sonar Reasoning Pro](https://spiral.ai/tools/openrouter/perplexity/sonar-reasoning-pro) (OpenRouter): Up to $0.04919 per run at the default inputs. $2.60 per 1M input tokens, $10.40 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 1 to 115200 | — | The most output tokens to generate. |
| temperature | 0 to 2 | — |  |
| presence_penalty | -2 to 2 | — |  |

## What can you do with Sonar Reasoning Pro in Windsurf?

Turn public technical research into decisions grounded in your project's requirements. Have your coding agent give Sonar Reasoning Pro a focused question, then compare its cited findings with the repository.

### Check a dependency upgrade

Use Sonar Reasoning Pro to research release notes and migration guidance, then produce a cited list of breaking changes to check against your application.

### Compare technical approaches

Ask Sonar Reasoning Pro to compare documented approaches against concrete requirements, explain tradeoffs, and identify unanswered questions before a prototype.

### Research competing products

Have Sonar Reasoning Pro compare publicly documented capabilities, distinguish announced features from available ones, and cite the evidence behind each finding.

### Investigate conflicting claims

Use Sonar Reasoning Pro to trace competing claims to their sources, compare dates and definitions, and explain where the evidence agrees or remains unresolved.

### Prepare a research brief

Ask Sonar Reasoning Pro to assemble a cited brief around one question, with the main findings, counterevidence, and gaps that need further investigation.

### Review public announcements

Use Sonar Reasoning Pro to summarize announcements within a stated period and explain which developments matter for a specific product or team.

### Check claims before publication

Give Sonar Reasoning Pro a set of factual claims and request supporting sources, conflicting evidence, and wording changes for claims it cannot verify.

## Overview

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

## Sonar Reasoning Pro in other agents

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

## More Windsurf guides

- [Sonar Pro Search](https://spiral.ai/integrations/windsurf/sonar-pro-search)
- [Step 3.7 Flash](https://spiral.ai/integrations/windsurf/step-3-7-flash)
- [Sonar Pro](https://spiral.ai/integrations/windsurf/sonar-pro)
- [Step 5 Preview](https://spiral.ai/integrations/windsurf/step-5-preview)
- [Sonar](https://spiral.ai/integrations/windsurf/sonar)
- [Ternary Bonsai 2 27B](https://spiral.ai/integrations/windsurf/ternary-bonsai-2-27b)

## Questions about Sonar Reasoning Pro in Windsurf

**Can Windsurf use Sonar Reasoning Pro?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Sonar Reasoning Pro like any built-in tool.

**How much does Sonar Reasoning Pro cost in Windsurf?**

Up to $0.04919 per run at the default inputs. $2.60 per 1M input tokens, $10.40 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need an OpenRouter account to use Sonar Reasoning Pro in Windsurf?**

No. Spiral runs Sonar Reasoning Pro on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Sonar Reasoning Pro in Windsurf?**

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

**Does Windsurf wait while Sonar Reasoning Pro runs?**

Sonar Reasoning Pro runs in the background. Windsurf starts the run, checks on it and gives you the text, json when it's ready.

**What is Sonar Reasoning Pro useful for?**

Use it for research questions that require finding evidence, comparing sources, and explaining a conclusion. Good tasks include technical due diligence, competitive research, and checking conflicting claims.

**How does Sonar Reasoning Pro differ from Sonar Reasoning?**

Sonar Reasoning Pro searches more sources and applies more deliberation. Choose it when the question requires weighing evidence from several sources.

**How much context can Sonar Reasoning Pro handle?**

Its context window is 128,000 tokens. Treat that as the context limit, not a promise that an answer can contain 128,000 tokens.

**Can Sonar Reasoning Pro return reliable JSON?**

You can request JSON, but the model does not enforce its format. Parse and validate the result before passing it to another process.

**What should I include in a research prompt?**

Name the subject, date range, relevant versions or locations, and the decision you need to make. A useful pattern is to request a comparison table, supporting citations, and a short conclusion.

