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

Windsurf · Lead Gen

How to Use UN sanctions list in Windsurf

Returns UN sanctions records as a paginated snapshot tied to one publication. Use it to collect a complete list or a sanctions regime for comparison and batch review.

Prompts to try with UN sanctions list in Windsurf

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

Use UN sanctions list to collect North Korea organization records across every page and write a JSON fixture for this project's batch review tests.

UN sanctions listWindsurf
Try asking
  • Use UN sanctions list to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from UN sanctions list and tell me what changed since last week.

  • Check UN sanctions list and summarize what you find in three bullet points.

  • Pull the newest data from UN sanctions list and give me the result as a table.

How to set up UN sanctions list 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 UN sanctions list

    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": "alexandria",
        "model": "scsanctions-un-org/sanctions/records_list",
        "input": {
          "lang": "en"
        }
      }'

Then paste one of the prompts above: Windsurf finds UN sanctions list on Spiral, shows the price and runs it.

UN sanctions list providers and prices

Spiral runs UN sanctions list through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen

Settings you can ask for

Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Langen, fr, ar, ru, sp, or chen

Language edition of the list: en (default), fr, ar, ru, sp (Spanish), ch (Chinese). The router's own codes; es and zh are not accepted upstream. Reference numbers and DATAIDs are the same in every edition, the publication id is not.

Page size1 to 200100

Records per page (default 100, max 200).

Entity typeperson or organization

Record type filter: person (the file's INDIVIDUALS) or organization (ENTITIES).

Every API field of UN Security Council Consolidated Sanctions List · Records list is on its tool page: open its card above.

What can you do with UN sanctions list in Windsurf?

Build a supplier review feature that shows UN-listed business names and the evidence behind candidate matches. Use UN records and publication metadata to make the results inspectable in your application.

Supplier onboarding review

Check the available publication, collect the relevant UN records, search a prospective supplier's business name, and inspect candidate entries. Produce a review table showing names, aliases, addresses, and UN references.

Shipping counterparty review

Compare freight counterparties with UN-listed organizations. Use publication metadata and a collected snapshot to document the source, then search company names and examine the identifying details behind candidate matches.

Recurring business rescreening

Compare the available UN publication with the previous collection, refresh the organization records, and rerun business-name checks. Fetch candidate records to explain which aliases, addresses, or listing details need review.

Screening software validation

Use public listed organizations such as Korea Mining Development Trading Corporation as test cases. Compare name-search candidates with full records and the collected list, while retaining publication metadata with the test results.

Sanctions regime briefing

Collect organization records for a UN sanctions regime and summarize the published names, aliases, addresses, and listing dates. Use publication status to identify the edition behind the briefing and individual records for detailed examples.

Questions about UN sanctions list in Windsurf

Can Windsurf use UN sanctions list?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run UN sanctions list like any built-in tool.

How much does UN sanctions list 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 UN sanctions list in Windsurf?

No. Spiral runs UN sanctions list on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up UN sanctions list in Windsurf?

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

Does Windsurf wait while UN sanctions list runs?

UN sanctions list runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

Which sanctions does this source cover?

It covers individuals and entities subject to UN Security Council sanctions measures. Its coverage boundary is Security Council designations, so a search here does not answer whether a business appears on a separate national sanctions list.

When does the UN update the data?

Changes follow sanctions committee decisions. For the ISIL and Al-Qaida list, the UN says changes take effect on the list immediately after the relevant decision, and the consolidated list is updated following those changes.

Does every entry have complete identifying information?

No. The UN explicitly uses "na" when the responsible committee has not obtained a detail, so the published list can contain incomplete identifying information.

Is an alias match enough to identify a listed party?

An informal alias alone can be insufficient. The UN's listing form specifically says nicknames and other informal pseudonyms generally do not establish a positive identification by themselves.

Where can I check what changed?

The UN maintains a separate public change log. It records the change date, sanctions list, permanent reference numbers, update type, affected-entry count, and links to notifications.

Get started

Start using UN sanctions list 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