[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [WIPO PATENTSCOPE query reference](https://spiral.ai/integrations/windsurf/wipo-patentscope-query-reference)

# How to Use WIPO PATENTSCOPE query reference in Windsurf

Returns PATENTSCOPE search field codes, patent office codes, or IPC classification symbols. Use it to identify the right search vocabulary before researching an applicant, technology, or collection.

|  |  |
| --- | --- |
| Model | WIPO PATENTSCOPE query reference |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with WIPO PATENTSCOPE query reference in Windsurf

- Use WIPO PATENTSCOPE query reference to retrieve IPC symbols beginning H02K and their titles, then add a readable classification table to docs/motor-research.md.
- Use WIPO PATENTSCOPE query reference to retrieve the search fields for applicants and publication dates, then document them in our patent research query builder.
- Use WIPO PATENTSCOPE query reference to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from WIPO PATENTSCOPE query reference and tell me what changed since last week.
- Check WIPO PATENTSCOPE query reference and summarize what you find in three bullet points.

## How to set up WIPO PATENTSCOPE query reference 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 WIPO PATENTSCOPE query reference**: 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": "patentscope-wipo-int/intellectual-property/reference",
    "input": {
      "list": "fields"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds WIPO PATENTSCOPE query reference on Spiral, shows the price and runs it.

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

## WIPO PATENTSCOPE query reference tools and prices

- [WIPO PATENTSCOPE patent search · Reference](https://spiral.ai/tools/alexandria/patentscope-wipo-int/intellectual-property/reference) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| lang | en, fr, de, es, pt, ru, ja, zh, ko, ar | en | lang |
| prefix |  | — | IPC symbol prefix (`B08B`, `H02K 1`); required for `ipc`, ignored otherwise. |

## What can you do with WIPO PATENTSCOPE query reference in Windsurf?

Build a patent research table with publication records, applicants, and technology classifications. A coding agent can use PATENTSCOPE references to shape queries and turn selected bibliographic data into a project report.

### Prepare a battery technology research brief

Look up relevant IPC symbols, find publications about solid-state batteries, and examine selected records for applicants, abstracts, and priority claims.

### Review a company's published research

Identify the applicant search field, find Toyota publications about hydrogen storage, and summarize the selected documents' technical subjects.

### Compare patent collections

Resolve the office codes for Japan and the European Patent Office, research the same technology in each collection, and compare selected publication records.

### Build a prior-art reading list

Use field and classification references to focus a technology search, then collect bibliographic details and abstracts for documents a researcher should read.

## Overview

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

## WIPO PATENTSCOPE query reference in other agents

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

## More Windsurf guides

- [WIPO PATENTSCOPE patent search](https://spiral.ai/integrations/windsurf/wipo-patentscope-patent-search)
- [WIPO trademark database coverage](https://spiral.ai/integrations/windsurf/wipo-trademark-database-coverage)
- [WIPO PATENTSCOPE patent details](https://spiral.ai/integrations/windsurf/wipo-patentscope-patent-details)
- [WIPO trademark database statistics](https://spiral.ai/integrations/windsurf/wipo-trademark-database-statistics)
- [Virginia SCC registered agent history](https://spiral.ai/integrations/windsurf/virginia-scc-registered-agent-history)
- [WIPO trademark details](https://spiral.ai/integrations/windsurf/wipo-trademark-details)

## Questions about WIPO PATENTSCOPE query reference in Windsurf

**Can Windsurf use WIPO PATENTSCOPE query reference?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run WIPO PATENTSCOPE query reference like any built-in tool.

**How much does WIPO PATENTSCOPE query reference 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 WIPO PATENTSCOPE query reference in Windsurf?**

No. Spiral runs WIPO PATENTSCOPE query reference on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up WIPO PATENTSCOPE query reference in Windsurf?**

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

**Does Windsurf wait while WIPO PATENTSCOPE query reference runs?**

WIPO PATENTSCOPE query reference runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**Does PATENTSCOPE cover every country's patents?**

It includes all published PCT applications plus collections from participating national and regional offices. That coverage boundary does not establish complete coverage of every country's patent records.

**How fresh is PATENTSCOPE data?**

Existing PCT bibliographic records and documents update daily, while new PCT applications normally publish on Thursday. National and regional collections update on an ad hoc basis rather than a shared daily schedule.

**Can PATENTSCOPE reveal applications before publication?**

PCT applications normally publish shortly after 18 months from their priority date, with earlier publication possible on request. Before publication, third-party access requires the applicant's request or authorization.

**How far back do published PCT records go?**

PATENTSCOPE's Gazette Archive provides searchable official publication lists back to 1978. This PCT archive boundary does not establish the historical coverage of each national collection.

**Can patent text contain transcription errors?**

Yes. WIPO identifies OCR errors as a limitation of the Description and Claims text and does not guarantee the database's accuracy or completeness.

