mcp-fssp

mcp-fssp

ФССП MCP サーバー：個人、企業、個人事業主の執行手続きについて、金額、ステータス、執行官の情報、徴収の根拠を確認できます。Cursor、Claude、任意の MCP クライアントに接続できます。

AI エージェント向けのロシアの執行官による債務照会ツールです。

以下を対象としています。

• 個人（氏名と生年月日で照会）。
• 法人（ИНН-10 / ОГРН-13 で照会）。
• 個人事業主（ИНН-12 / ОГРНИП-15 で照会）。

ロシアの取引先に関するデューデリジェンス向け MCP サーバーファミリー atomno の一部です。 mcp-egrul（法人情報）· mcp-fns-check（税務コンプライアンス）· mcp-cbr-rates（中央銀行の為替レート）· mcp-fssp（ФССП の債務）。

目的

ФССП の公式 API（api-ip.fssp.gov.ru）は2022年3月10日以降停止されており、復旧の予定はありません。唯一の公式窓口は、CAPTCHA がある公開 Web サービス fssp.gov.ru/iss/ip です。そこで、複数の商用プロバイダー（Damia / Checko / NewDB / api-cloud）に対応し、データモデルを標準化した MCP ラッパーが役立ちます。

主なユースケース：

• Cursor / Claude Desktop の AI エージェントが、ФССП のサイトを手作業で確認するのに10分かかるところを、チャット内で30秒で取引先のデューデリジェンスを行います。
• 弁護士／銀行／スコアリングでは、異なる3〜4社のプロバイダーからの未加工の応答を解析せずに、統一された check_*_debts 呼び出しを Python スクリプトや1Сに組み込めます。
• セルフホストを好むユーザーは、自分の Damia / Checko キーを使ってクライアントをローカルにインストールし、サードパーティの SaaS に依存せずに利用できます。個人データ漏えいへの懸念を軽減します。

クイックスタート

1. インストール

# Через pipx (рекомендуется для CLI):
pipx install atomno-mcp-fssp

# Или через uv (быстрее):
uvx atomno-mcp-fssp

# Или классически через pip:
pip install atomno-mcp-fssp

2. プロバイダーキーを取得

少なくとも1つ必要です。

• Damia（https://api-fssp.damia.ru）— 本番環境向けの第一候補です。年間7,000 ₽から、1,000件のリクエストに対応します。テスト用に100件のリクエストを無料で利用できます。
• Checko（https://api.checko.ru）— 1日あたり最大50件のリクエストを無料で利用できます。オンボーディングに適しています。
• NewDB（https://newdb.net/fssp/api）— 手頃な価格の代替サービスです。1件あたり2 ₽、100件無料です。
• api-cloud（https://api-cloud.ru/api/fssp.php）— リクエストごとの従量課金です。

3. 設定

作業ディレクトリに .env を作成するか、MCP 設定を通じて環境変数を渡します。

MCP_FSSP_PROVIDER=damia
MCP_FSSP_DAMIA_KEY=ваш_ключ_от_Damia

環境変数の一覧については、.env.example を参照してください。

4. Cursor に接続

~/.cursor/mcp.json（または Settings → MCP）を開き、次の設定を追加します。

{
  "mcpServers": {
    "fssp": {
      "command": "uvx",
      "args": ["atomno-mcp-fssp"],
      "env": {
        "MCP_FSSP_PROVIDER": "damia",
        "MCP_FSSP_DAMIA_KEY": "ваш_ключ"
      }
    }
  }
}

Cursor を再起動します。これで AI エージェントは fssp.check_individual_debts(...)、fssp.check_legal_entity_debts(...)、fssp.get_proceeding_details(...) を呼び出せるようになります。

5. Claude Desktop に接続

claude_desktop_config.json を開き、次の設定を追加します。

{
  "mcpServers": {
    "fssp": {
      "command": "uvx",
      "args": ["atomno-mcp-fssp"],
      "env": {
        "MCP_FSSP_PROVIDER": "damia",
        "MCP_FSSP_DAMIA_KEY": "ваш_ключ"
      }
    }
  }
}

利用可能なツール

ツール	用途
ping	サーバーの準備状況と現在のプロバイダーを確認します。
check_individual_debts(fio, birth_date, region?)	個人の未完了の執行手続き一覧を取得します。
check_legal_entity_debts(inn?, ogrn?)	法人または個人事業主の未完了の執行手続き一覧を取得します。
get_proceeding_details(proceeding_id)	番号を指定して、1件の執行手続きの詳細を取得します。

Pro 版（Phase 3 以降。ATOMNO_API_KEY が必要）では、以下も利用できます。

• summarize_debts(...) — カテゴリー分類とリスクスコアを含む、債務の AI サマリーです。
• monitor_debts_changes(...) — webhook / Telegram アラートによる変更通知を購読します。

環境変数

変数	用途	デフォルト
MCP_FSSP_PROVIDER	プロバイダー：damia / checko / newdb / api_cloud / self_parser / atomno_pro	damia
MCP_FSSP_DAMIA_KEY	Damia API-ФССП のキー	—
MCP_FSSP_CHECKO_KEY	Checko v2 のキー	—
MCP_FSSP_NEWDB_KEY	NewDB のキー	—
MCP_FSSP_API_CLOUD_KEY	api-cloud.ru のキー	—
ATOMNO_API_KEY	Pro モードのキー（api.atomno-mcp.ru/fssp/）	—
ATOMNO_API_BASE	Pro バックエンドの URL	https://api.atomno-mcp.ru/mcp-fssp/v1
MCP_FSSP_HTTP_TIMEOUT	1 回のリクエストのタイムアウト（秒）	15
MCP_FSSP_RPS	クライアント側の 1 分あたりのリクエスト上限	30
MCP_FSSP_USER_AGENT	リクエスト用の User-Agent	mcp-fssp/0.1 (...)
MCP_FSSP_AUDIT_DB	SQLite 監査ログのパス	./audit.sqlite
MCP_FSSP_LOG_LEVEL	ログレベル：DEBUG/INFO/WARNING/ERROR	INFO

セキュリティと個人データ

• 個人データ（氏名、生年月日）はプレーンテキストで保存されません。監査ログには sha256(fio_lower + birth_date) のみが保存されます。
• 229-ФЗ 第 6.1 条に基づき、執行手続きデータバンクの情報は公開情報であり、債務者の同意なしに利用できます。
• ただし、商業目的で利用する場合、事業者は152-ФЗを遵守する義務があります。適法な目的での利用（例：取引前のデューデリジェンス、借り手の同意を得たスコアリング）は、ユーザーの責任で行ってください。

免責事項

本サービスは、公開されている ФССП データを集約し、使いやすいインターフェースで提供するもの（229-ФЗ 第 6.1 条）です。ФССП ロシア、Damia、Checko、NewDB、api-cloud およびその他のプロバイダーとは提携していません。ご自身の責任でご利用ください。

ツールが返す情報は参考情報であり、ФССП が発行する公式文書に代わるものではありません。プロバイダーのデータの最新性、完全性、正確性について、作成者は責任を負いません。情報の適法な利用（個人データの処理における 152-ФЗ の遵守を含む）に関する責任は、ユーザーが負います。

法的効力のある決定（例：融資の拒否）を行う場合は、債務者本人から、または公式な経路（執行官部署への照会）を通じて、一次資料を取得する必要があります。

ロードマップ

• v0.1（現行）— Phase 0 のスキャフォールド + Damia プロバイダー + check_individual_debts。
• v0.2 — マルチプロバイダー対応（+Checko、NewDB、api-cloud）、check_legal_entity_debts、get_proceeding_details、ローカル L1 キャッシュ。
• v0.3+ — CAPTCHA ソルバーを使用した self_parser。
• v0.5 — Pro バックエンド（api.atomno-mcp.ru/fssp/）との統合：summarize_debts、monitor_debts_changes、30 日間の L2 キャッシュ、3 プロバイダーによるフォールバック。

ツールと環境変数のドキュメントは、この README と CHANGELOG.md にあります。公開後は GitHub の atomno-mcp/mcp-fssp にも掲載されます。

ライセンス

MIT © 2026 atomno.

Pro バックエンド（atomno-mcp/mcp-fssp-server）はPhase 2 での提供を予定しています（プロプライエタリライセンスのプライベートなホステッドサービス）。オープンクライアントはバックエンドなしで完全に動作します。ユーザーは 4 つの商用プロバイダーのいずれかのキーを設定できます。

リンク

• ФССП API 仕様（過去のもの）：api-ip.fssp.gov.ru（2022 年 3 月 10 日に停止）。
• ФССП Web サービス：fssp.gov.ru/iss/ip。
• MCP カタログ：glama.ai/mcp/servers。
• MCP 仕様：modelcontextprotocol.io。