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

# How to Use OpenSanctions entity search in Cline

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 Cline

- Use OpenSanctions entity search to find Sberbank and populate the project’s research results view with the returned names, topics, and contributing datasets.
- Use OpenSanctions entity search to find Rosoboronexport and save the returned company records as a real-data example for this project’s research interface.
- Use OpenSanctions entity search to look this up and give me the result as a table. Save the result in ./assets.
- 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 Cline

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

### Use Spiral's MCP server

1. **Add the server**: In the Cline panel, click the MCP Servers icon and open the Remote Servers tab. Enter:

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

2. **Sign in**: Open the Configure tab and click Authenticate on the Spiral server. Sign in to Spiral, pick the organization and click Authorize. No API key.

3. **Check it**: Spiral shows as connected on the Configure tab. In the CLI:

```bash
cline config mcp
```

### Use the Spiral skill

1. **Send Cline 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: Cline finds OpenSanctions entity search on Spiral, shows the price and runs it.

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

## 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 Cline?

Build a company research view that connects findings to the watchlists behind them. OpenSanctions supplies entity records and source descriptions that a coding agent can organize into reviewable evidence.

### 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 Cline guides](https://spiral.ai/integrations/cline)

## OpenSanctions entity search in other agents

- [Amp](https://spiral.ai/integrations/amp/opensanctions-entity-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/opensanctions-entity-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/opensanctions-entity-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/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 Cline guides

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

## Questions about OpenSanctions entity search in Cline

**Can Cline use OpenSanctions entity search?**

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

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

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

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

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

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

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

OpenSanctions entity search runs in the background. Cline 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.

