# osintverse-community/opensanctions

Screens a person's or company's name against OpenSanctions: sanctions lists, politically exposed persons, watch lists

## Install and run

```sh
ot install osintverse-community/opensanctions
ot run osintverse-community/opensanctions
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/opensanctions","inputs":{"name":"Vladimir Putin"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `name` | name | no |  | A person's full name (give exactly one of name or company) |
| `company` | company | no |  | A company or organisation name (give exactly one of name or company) |
| `birth_date` | string | no |  | The person's date or year of birth, such as 1952 or 1952-10-07, to tell namesakes apart |
| `country` | string | no |  | A country linked to the person or company (nationality, residence or jurisdiction), as a name or code |
| `limit` | integer | no | `5` | Most matches to return (up to 25) |

## Outputs

Finds: person, organization, other.

- `person`: Listed people: score, topics (sanction, role.pep, crime...), sources, countries, positions, birth date
- `organization`: Listed companies and organisations
- `other`: Other listed things, such as vessels and aircraft

## What a run does

- Does not contact the target.
- Collects personal data.
- Needs an account (it logs in, or uses an account or API key of yours).
- Does not notify the target.
- Usually takes about 2 seconds.
- Publisher's note: Shows the sanctions, PEP and watch-list records whose names match; a match on a name alone may be a different person, and being a politically exposed person is not wrongdoing.
- Connects to api.opensanctions.org.

An agent needs the person's consent before running this tool, because it collects personal data. See https://otinstaller.com/docs/agents#consent.

## API keys

- `OPENSANCTIONS_API_KEY` (required, paid): Your OpenSanctions API key: paid per query for businesses after trial credits; free for journalists, NGOs and researchers who apply Get one at https://www.opensanctions.org/account/

Store a key with `ot keys set NAME`; it stays in the OS keychain.

## Trust

- Latest version: 0.1.0
- Signed: yes
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/opensanctions

## Links

- Web page: https://otinstaller.com/osintverse-community/opensanctions
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/opensanctions
- README: https://github.com/osintverse-community/opensanctions#readme
- Security details: https://otinstaller.com/osintverse-community/opensanctions/security
- Report a problem: https://otinstaller.com/osintverse-community/opensanctions/report