[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Wowhead search suggestions](https://spiral.ai/integrations/windsurf/wowhead-search-suggestions)

# How to Use Wowhead search suggestions in Windsurf

Returns Wowhead name matches for game entities and content. Use it to identify the intended item or spell before looking up its tooltip.

|  |  |
| --- | --- |
| Model | Wowhead search suggestions |
| Available through | Alexandria |
| Category | News & Media |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Wowhead search suggestions in Windsurf

- Use Wowhead search suggestions for Thunderfury and show the returned names, entity types, and IDs in my project's lookup view.
- Use Wowhead search suggestions to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Wowhead search suggestions and tell me what changed since last week.
- Check Wowhead search suggestions and summarize what you find in three bullet points.
- Pull the newest data from Wowhead search suggestions and give me the result as a table.

## How to set up Wowhead search suggestions 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 Wowhead search suggestions**: 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": "alexandria",
    "model": "wowhead-com/news/search_suggest",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Wowhead search suggestions on Spiral, shows the price and runs it.

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

## Wowhead search suggestions tools and prices

- [Wowhead · Search suggest](https://spiral.ai/tools/alexandria/wowhead-com/news/search_suggest) (Alexandria): $0.00873 per call.

## What can you do with Wowhead search suggestions in Windsurf?

Build a personal WoW research panel with linked reporting and game-entity references. Use Wowhead results to populate the project with source data for review.

### Personal patch research

Collect recent patch headlines, trace earlier reporting, find the named spells or items, and check their tooltips before writing personal notes.

### Returning-player reading list

Build a reading list from current and older WoW coverage, then add name matches and tooltip explanations for unfamiliar game terms.

### Item-change research

Find news mentioning a specific item, locate its database match, and compare the reported change with the tooltip currently returned.

### Class update notebook

Gather current and historical class headlines, identify the spells mentioned, and keep their tooltip descriptions beside personal research notes.

### Game terminology lookup

Resolve names such as Thunderfury or Frostbolt, distinguish the returned entity types, and read the appropriate tooltip.

## Overview

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

## Wowhead search suggestions in other agents

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

## More Windsurf guides

- [Wowhead page comments](https://spiral.ai/integrations/windsurf/wowhead-page-comments)
- [Zockify WoW Forever class guide](https://spiral.ai/integrations/windsurf/zockify-wow-forever-class-guide)
- [Wowhead news article](https://spiral.ai/integrations/windsurf/wowhead-news-article)
- [Zockify WoW Forever gear rankings](https://spiral.ai/integrations/windsurf/zockify-wow-forever-gear-rankings)
- [Wowhead news archive](https://spiral.ai/integrations/windsurf/wowhead-news-archive)
- [Zockify WoW Forever stat weights](https://spiral.ai/integrations/windsurf/zockify-wow-forever-stat-weights)

## Questions about Wowhead search suggestions in Windsurf

**Can Windsurf use Wowhead search suggestions?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Wowhead search suggestions like any built-in tool.

**How much does Wowhead search suggestions cost in Windsurf?**

$0.00873 per call. 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 Alexandria account to use Wowhead search suggestions in Windsurf?**

No. Spiral runs Wowhead search suggestions on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Wowhead search suggestions in Windsurf?**

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

**Does Windsurf wait while Wowhead search suggestions runs?**

Wowhead search suggestions runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**Does Wowhead cover games besides World of Warcraft?**

Yes. Wowhead explicitly documents tooltip coverage for both World of Warcraft and Diablo 4.

**How quickly does player-submitted game data appear?**

Wowhead says submitted database data appears after internal approval, typically in about a week. That timing applies to player submissions, rather than a promised news publishing schedule.

**Is Wowhead news written by Blizzard?**

Wowhead says its own content team maintains the news and guide sections. A Wowhead report should therefore be attributed to Wowhead unless it explicitly identifies a Blizzard source.

**Where does Wowhead's observed game data come from?**

Its Looter addon collects anonymous gameplay interactions, including boss loot and NPC discoveries. This is contributed observation data.

**Can I search Wowhead suggestions with a page URL?**

The suggestions service matches names rather than URLs. Search for an entity name such as Thunderfury, then use the returned type and ID to distinguish the match.

