[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [UN sanctions name search](https://spiral.ai/integrations/claude-code/un-sanctions-name-search)

# How to Use UN sanctions name search in Claude Code

Returns candidate entries from a name search of the UN consolidated sanctions data. Use it to find a business's UN reference number before examining its full record.

|  |  |
| --- | --- |
| Model | UN sanctions name search |
| 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 name search in Claude Code

- Use UN sanctions name search to find Korea Mining Development Trading Corporation and add a test that displays candidate UN references without automatically approving or rejecting a supplier.
- Use UN sanctions name search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from UN sanctions name search and tell me what changed since last week.
- Check UN sanctions name search and summarize what you find in three bullet points.
- Pull the newest data from UN sanctions name search and give me the result as a table.

## How to set up UN sanctions name search in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 name search**: 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/search",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds UN sanctions name search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## UN sanctions name search tools and prices

- [UN Security Council Consolidated Sanctions List · Search](https://spiral.ai/tools/alexandria/scsanctions-un-org/sanctions/search) (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. |
| limit | 1 to 100 | 20 | limit |
| 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. |
| entity_type | person, organization | — | Record type filter: person (the file's INDIVIDUALS) or organization (ENTITIES). |

## What can you do with UN sanctions name search in Claude Code?

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.

### Business alias investigation

Search a company's trading name and inspect candidate records for aliases, former names, and addresses. Prepare an evidence table that makes similarities and differences visible to the reviewer.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## UN sanctions name search in other agents

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

## More Claude Code guides

- [UN sanctions list](https://spiral.ai/integrations/claude-code/un-sanctions-list)
- [UN sanctions publication status](https://spiral.ai/integrations/claude-code/un-sanctions-publication-status)
- [UK sanctions name search](https://spiral.ai/integrations/claude-code/uk-sanctions-name-search)
- [UN sanctions record](https://spiral.ai/integrations/claude-code/un-sanctions-record)
- [UK sanctions list records](https://spiral.ai/integrations/claude-code/uk-sanctions-list-records)
- [UNGM contract award details](https://spiral.ai/integrations/claude-code/ungm-contract-award-details)

## Questions about UN sanctions name search in Claude Code

**Can Claude Code use UN sanctions name search?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run UN sanctions name search like any built-in tool.

**How much does UN sanctions name search cost in Claude Code?**

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

**Do I need an Alexandria account to use UN sanctions name search in Claude Code?**

No. Spiral runs UN sanctions name search 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 name search in Claude Code?**

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

**Does Claude Code wait while UN sanctions name search runs?**

UN sanctions name search runs in the background. Claude Code 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.

