[Integrations](https://spiral.ai/integrations) › [ChatGPT](https://spiral.ai/integrations/chatgpt) › [OpenSanctions entity search](https://spiral.ai/integrations/chatgpt/opensanctions-entity-search)

# How to Use OpenSanctions entity search in ChatGPT

Returns matching entity records with country, topic, and source facets. Use it to find companies or vessels for further research; OpenSanctions says full-text search is unsuitable for building an automated screening process.

|  |  |
| --- | --- |
| Model | OpenSanctions entity 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 OpenSanctions entity search in ChatGPT

- Use OpenSanctions entity search to find Sberbank. Show the returned company names, reasons for inclusion, and contributing sources.
- Use OpenSanctions entity search to research Sovcomflot. Show the matching company records and explain which sources contributed them.
- Use OpenSanctions entity search to look this up and give me the result as a table.
- Pull the latest numbers from OpenSanctions entity search and tell me what changed since last week.
- Check OpenSanctions entity search and summarize what you find in three bullet points.

## How to set up OpenSanctions entity search in ChatGPT

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

### Use the ChatGPT connector

1. **Add a custom MCP server**: In ChatGPT open Plugins, then Add › Add custom MCP server. Name it Spiral, paste this URL and keep Authentication on OAuth. Tick I understand and want to continue, then click Create.

```text
https://api.spiral.ai/mcp
```

2. **Click Connect**: ChatGPT asks to connect Spiral. Connect takes you to Spiral in your browser.

3. **Sign in to Spiral and approve**: Sign in, pick the organization ChatGPT should use and click Authorize. Spiral gives the connection its own API key; ChatGPT never sees it, and you can remove the connection under Settings › Connected apps.

### Use the Spiral skill

1. **Send ChatGPT 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 OpenSanctions entity 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": "opensanctions-org/sanctions-screening/search_entities",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: ChatGPT finds OpenSanctions entity search on Spiral, shows the price and runs it.

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

## OpenSanctions entity search tools and prices

- [OpenSanctions · Search entities](https://spiral.ai/tools/alexandria/opensanctions-org/sanctions-screening/search_entities) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Free-text name query. Optional when at least one filter is given. |
| scope |  | — | Dataset or collection to search within (default: the site's 'default' collection). Pattern: ^[a-z0-9_]{2,80}$. |
| schema |  | — | FollowTheMoney schema name: Person, Company, Organization, LegalEntity, PublicBody, Vessel, Airplane, Address, CryptoWallet, Security. Pattern: ^[A-Z][A-Za-z]{2,40}$. |
| topics |  | — | FollowTheMoney topic codes, e.g. sanction, sanction.linked, role.pep, role.rca, poi, wanted, crime, debarment, export.control. |
| datasets |  | — | Restrict to entities present in these dataset names (us_ofac_sdn, eu_fsf, wikidata, ...). |
| countries |  | — | Lower-case country codes as OpenSanctions uses them, including historic/territory codes (ru, ua, suhh, ua-cri, eu). |

## What can you do with OpenSanctions entity search in ChatGPT?

Prepare a company research brief with evidence from OpenSanctions and an explanation of the underlying sources. A chat assistant can turn returned records into a readable account of what the database says and why the company appears.

### Prepare a supplier research packet

Discover relevant sanctions sources, inspect their coverage, find a public supplier such as Sberbank, and examine its entity profile. Assemble the findings and contributing sources for a reviewer.

### Compare sanctions authorities

Identify US and EU source datasets, read their descriptions, and investigate how a company appears in the returned records. Explain which authorities contribute to its profile.

### Research a shipping company

Find sources relevant to maritime sanctions, inspect their coverage, and research Sovcomflot or another public shipping company. Examine returned sanctions records and business relationships for a shipping review.

### Investigate procurement exclusions

Discover debarment sources and inspect their publishers and coverage. Browse relevant company records, then examine individual profiles to prepare a procurement research brief.

### Explain a company finding

Find a public company by name, then inspect its profile to distinguish sanctions records from other reasons for inclusion. Present the supporting records for a human review.

## Overview

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

## OpenSanctions entity search in other agents

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

## More ChatGPT guides

- [OpenSanctions entity profile](https://spiral.ai/integrations/chatgpt/opensanctions-entity-profile)
- [Openmart brand search](https://spiral.ai/integrations/chatgpt/openmart-brand-search)
- [OpenSanctions dataset details](https://spiral.ai/integrations/chatgpt/opensanctions-dataset-details)
- [Openmart business lookup](https://spiral.ai/integrations/chatgpt/openmart-business-lookup)
- [OpenSanctions dataset catalog](https://spiral.ai/integrations/chatgpt/opensanctions-dataset-catalog)
- [Openmart local business search](https://spiral.ai/integrations/chatgpt/openmart-local-business-search)

## Questions about OpenSanctions entity search in ChatGPT

**Can ChatGPT use OpenSanctions entity search?**

Yes. Add Spiral to ChatGPT as an MCP server, and ChatGPT can find and run OpenSanctions entity search like any built-in tool.

**How much does OpenSanctions entity search cost in ChatGPT?**

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

**Do I need an Alexandria account to use OpenSanctions entity search in ChatGPT?**

No. Spiral runs OpenSanctions entity 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 OpenSanctions entity search in ChatGPT?**

About two minutes: add a custom MCP server, then click Connect, then sign in to Spiral and approve.

**Does ChatGPT wait while OpenSanctions entity search runs?**

OpenSanctions entity search runs in the background. ChatGPT starts the run, checks on it and gives you the json when it's ready.

**Is everyone listed in OpenSanctions sanctioned?**

No. OpenSanctions also includes records connected to criminal matters and public office. A listing’s reason must be checked before describing it as a sanctions designation.

**Where does OpenSanctions get its information?**

It collects records from sanctions authorities, government registries, and public records worldwide. Dataset descriptions identify publishers and explain source coverage.

**Does OpenSanctions cover procurement bans?**

Yes. Its inclusion criteria explicitly cover companies and individuals excluded or debarred from procurement, extending its coverage beyond sanctions lists.

**What tells me whether a source is maintained?**

OpenSanctions dataset metadata includes maintenance status, update timestamps, and temporal coverage. These describe the individual source rather than promising one update schedule for every dataset.

**Why does a search result show less detail than an entity profile?**

Search results contain the entity’s own properties, including names, identifiers, and key dates. Detailed relationships are retrieved through an entity lookup.

