[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [UN sanctions list](https://spiral.ai/integrations/opencode/un-sanctions-list)

# How to Use UN sanctions list in opencode

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.

|  |  |
| --- | --- |
| Model | UN sanctions list |
| 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 UN sanctions list in opencode

- 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.
- 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 opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 UN sanctions list**: 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": "scsanctions-un-org/sanctions/records_list",
    "input": {
      "lang": "en"
    }
  }'
```

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

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

## UN sanctions list tools and prices

- [UN Security Council Consolidated Sanctions List · Records list](https://spiral.ai/tools/alexandria/scsanctions-un-org/sanctions/records_list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| lang | en, fr, ar, ru, sp, ch | en | 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. |
| regime |  | — | Regime filter: a UN_LIST_TYPE value (Al-Qaida, Taliban, DPRK, Iraq, DRC, Iran, Libya, Somalia, CAR, Sudan, GB, Yemen, Haiti, SouthSudan) or its scsanctions.un.org slug (al-qaida, dprk, southsudan ...), case-insensitive. Unknown values are invalid_input. |
| page_size | 1 to 200 | 100 | Records per page (default 100, max 200). |
| entity_type | person, organization | — | Record type filter: person (the file's INDIVIDUALS) or organization (ENTITIES). |
| continuation |  | — | The cursor returned in meta.page.next_cursor of the previous page. |

## What can you do with UN sanctions list in opencode?

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.

## Overview

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

## UN sanctions list in other agents

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

## More opencode guides

- [UK sanctions name search](https://spiral.ai/integrations/opencode/uk-sanctions-name-search)
- [UN sanctions name search](https://spiral.ai/integrations/opencode/un-sanctions-name-search)
- [UK sanctions list records](https://spiral.ai/integrations/opencode/uk-sanctions-list-records)
- [UN sanctions publication status](https://spiral.ai/integrations/opencode/un-sanctions-publication-status)
- [UK sanctions list publication status](https://spiral.ai/integrations/opencode/uk-sanctions-list-publication-status)
- [UN sanctions record](https://spiral.ai/integrations/opencode/un-sanctions-record)

## Questions about UN sanctions list in opencode

**Can opencode use UN sanctions list?**

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

**How much does UN sanctions list cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use UN sanctions list in opencode?**

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 opencode?**

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

**Does opencode wait while UN sanctions list runs?**

UN sanctions list runs in the background. opencode 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.

