Metadata-Version: 2.5
Name: atomno-mcp-sanctions
Version: 0.1.1
Summary: MCP server: sanctions and watchlist screening for persons and entities — Rosfinmonitoring, OFAC SDN, EU, UK OFSI, UN lists. Neutral match results with confidence levels; advisory KYC/AML compliance tool.
Project-URL: Homepage, https://github.com/atomno-mcp/mcp-sanctions
Project-URL: Repository, https://github.com/atomno-mcp/mcp-sanctions
Project-URL: Issues, https://github.com/atomno-mcp/mcp-sanctions/issues
Project-URL: Changelog, https://github.com/atomno-mcp/mcp-sanctions/blob/main/CHANGELOG.md
Project-URL: Documentation, https://atomno-mcp.ru/mcp/sanctions
Author-email: atomno-mcp <hello@atomno.ru>
License: MIT
License-File: LICENSE
Keywords: aml,atomno,compliance,fintech,kyc,mcp,model-context-protocol,ofac,rosfinmonitoring,russia,sanctions,watchlist
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Russian
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: fastmcp<4.0.0,>=3.0.0
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: mcp<2.0.0,>=1.0.0
Requires-Dist: pydantic<3.0.0,>=2.6.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.1; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: release
Requires-Dist: build>=1.2.0; extra == 'release'
Requires-Dist: twine>=5.1.0; extra == 'release'
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.atomno-mcp/mcp-sanctions -->
# atomno-mcp-sanctions

**Скрининг по санкционным перечням прямо в AI-ассистенте** — sanctions and watchlist
screening for persons and organizations: Rosfinmonitoring, OFAC SDN, EU consolidated,
UK OFSI, UN Security Council. Works in Cursor, Claude Desktop, Cline, and any MCP client.

Проверьте контрагента или физлицо по публичным перечням за один вызов — с
**нейтральной** выдачей (уровень совпадения, версия перечня, дата проверки) и
обязательной ручной верификацией.

> Инструмент **не выносит суждений** о лице и **не является основанием** для
> решений сам по себе. Список отказников ЦБ **не поддерживается** (не публичен).

## Что умеет

- **screen_person** — скрининг физлица по ФИО (+ опционально дата рождения).
- **screen_entity** — скрининг организации по наименованию, ИНН, ОГРН.
- **screen_inn** — быстрый поиск по ИНН.
- **list_watchlists** — метаданные поддерживаемых перечней и дат обновления.

## Быстрый старт

```bash
pipx install atomno-mcp-sanctions
# или: uvx atomno-mcp-sanctions
```

Cursor / Claude Desktop (`mcp.json`):

```json
{
  "mcpServers": {
    "sanctions": {
      "command": "uvx",
      "args": ["atomno-mcp-sanctions"],
      "env": { "MCP_SANCTIONS_API_KEY": "<ваш-ключ-Pro>" }
    }
  }
}
```

## Переменные окружения

| Переменная | Описание | Обязательна |
|---|---|---|
| `MCP_SANCTIONS_API_KEY` | Ключ Pro (заголовок X-API-Key). [Получить](https://atomno-mcp.ru/pricing#sanctions-pro) | да |
| `MCP_SANCTIONS_API_BASE` | URL hosted-бэкенда (default: `https://api.atomno-mcp.ru/sanctions`) | нет |
| `MCP_SANCTIONS_TIMEOUT` | Таймаут HTTP, сек (default: 30) | нет |
| `MCP_SANCTIONS_LOG_LEVEL` | Уровень логов (перебивается `--log-level`) | нет |

## CLI

```bash
atomno-mcp-sanctions --help
atomno-mcp-sanctions --version
atomno-mcp-sanctions --transport stdio
```

## Disclaimer

Каждый ответ содержит поле `disclaimer`: инструмент сообщает только о совпадении
с записью публичного перечня на указанную дату; данные могут устаревать.
Ответственность за принимаемые решения несёт пользователь.

## Лицензия

MIT — см. [LICENSE](LICENSE).

Не аффилировано с Росфинмониторингом, OFAC, Еврокомиссией, HM Treasury или ООН.
