Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · LLMReleased 2025-04-05

How to Use Llama 4 Maverick in Windsurf

Llama 4 Maverick handles coding, multilingual chat, image questions, and creative writing. Compared with Llama 4 Scout, its documented context window is smaller: 1 million versus 10 million tokens.

Prompts to try with Llama 4 Maverick in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use Llama 4 Maverick to review the current diff for behavior changes and likely bugs. For each finding, cite the file and relevant code, explain a concrete failure case, and suggest a focused test.

Llama 4 MaverickWindsurf
Try asking
  • Use Llama 4 Maverick to investigate the latest failing test using the test output and relevant project files. Explain the likely cause, propose the smallest fix, and identify what to rerun.

  • Use Llama 4 Maverick to trace how an incoming request reaches the database in this project. Cite the functions involved and flag any step you cannot establish from the files.

  • Use Llama 4 Maverick to draft Spanish and French versions of the English help text in this project. Preserve interpolation tokens and product names, and flag phrases that need more context.

  • Use Llama 4 Maverick to draft release notes from the current diff and project documentation. Separate user-visible changes from internal changes, keep the draft under 400 words, and flag uncertain claims.

How to set up Llama 4 Maverick 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:

    {
      "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.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Llama 4 Maverick

    One request; the result comes back by polling or a webhook.

    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": "meta-llama/llama-4-maverick",
        "input": {
          "messages": [
            {
              "role": "system"
            }
          ]
        }
      }'

Then paste one of the prompts above: Windsurf finds Llama 4 Maverick on Spiral, shows the price and runs it.

Llama 4 Maverick providers and prices

Spiral runs Llama 4 Maverick through OpenRouter. Open a card for today's price, with every fee included.

OpenRouterLLM
Meta: Llama 4 Maverick
meta-llama/llama-4-maverick

Settings you can ask for

Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Seeda whole number
Top ka whole number from 0
Top p0 to 1
Logprobson or off
Max tokens1 to 32768

The most output tokens to generate.

Temperature0 to 2
Top logprobs0 to 20
Presence penalty-2 to 2
Frequency penalty-2 to 2
Repetition penalty0 to 2

Every API field of Meta: Llama 4 Maverick is on its tool page: open its card above.

What can you do with Llama 4 Maverick in Windsurf?

Llama 4 Maverick can help turn project code and failure logs into review findings, explanations, and proposed fixes. Give it the relevant files and ask for evidence tied to the code before testing its suggestions.

Review a code change

Use Llama 4 Maverick to examine a proposed change, explain likely defects, and suggest tests tied to specific behavior.

Explain a failing test

Give Llama 4 Maverick the relevant code and failure output. Ask for a likely cause, a minimal correction, and a way to verify the fix.

Draft multilingual support replies

Ask Llama 4 Maverick to draft replies in a supported language using supplied product guidance. Require it to flag questions the guidance does not answer.

Summarize several documents

Have Llama 4 Maverick combine supplied documents into a brief that separates shared conclusions, disagreements, and unanswered questions.

Describe product photos

Ask Llama 4 Maverick for English descriptions grounded in visible details. Require it to leave out unverified materials, dimensions, and performance claims.

Answer questions about a chart

Give Llama 4 Maverick a chart image and ask in English about the visible trends. Request the labels or values supporting each observation.

Explore different writing approaches

Use Llama 4 Maverick to draft several openings, explanations, or short stories from the same brief. Specify how the approaches should differ.

Prepare answers from reference material

Ask Llama 4 Maverick to answer customer or internal questions using supplied reference text, with a supporting excerpt and a clear indication of missing information.

Questions about Llama 4 Maverick in Windsurf

Can Windsurf use Llama 4 Maverick?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Llama 4 Maverick like any built-in tool.

How much does Llama 4 Maverick cost in Windsurf?

Up to $0.005342 per run at the default inputs. $0.455 per 1M input tokens, $1.30 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 Llama 4 Maverick in Windsurf?

No. Spiral runs Llama 4 Maverick on its own OpenRouter account. You sign in to Spiral once and never paste a key.

How long does it take to set up Llama 4 Maverick in Windsurf?

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

Does Windsurf wait while Llama 4 Maverick runs?

Llama 4 Maverick runs in the background. Windsurf starts the run, checks on it and gives you the text, json when it's ready.

What is Llama 4 Maverick good at?

Llama 4 Maverick is useful for code analysis, multilingual conversations, document summaries, image questions, and creative drafts. Give it the source material and a specific deliverable, such as a bug explanation or a summary with supporting excerpts.

Which languages does Llama 4 Maverick support?

Text support covers Arabic, English, French, German, Hindi, Indonesian, Italian, Portuguese, Spanish, Tagalog, Thai, and Vietnamese. Use English for image questions; documented image understanding is limited to English.

How much context can Llama 4 Maverick handle?

Its documented model context length is 1 million tokens, compared with 10 million for Llama 4 Scout. Treat that as context capacity, not a promise about the length of one answer.

How should I prompt Llama 4 Maverick?

State the task, supply the relevant material, and specify the audience, format, and length. Include an example when the output needs to follow a repeated pattern.

Which setting matters for creative writing?

Temperature is useful when you want more creative alternatives. Increase it while comparing drafts, and keep the audience, length, and factual requirements explicit.

Get started

Start using Llama 4 Maverick in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options