mcp-fssp

Consultas de deudas del FSSP (Servicio Federal de Alguaciles) de Rusia a través de MCP — verifique procedimientos de ejecución (исполнительные производства) para personas físicas y jurídicas directamente desde Cursor, Claude Desktop, Cl...

GitHubPrueba este MCPPatrocinado

Documentación

mcp-fssp

Servidor MCP de FSSP: consulta de procedimientos de ejecución para personas, empresas y empresarios individuales — montos, estados, datos del oficial de justicia y motivo del cobro. Se conecta a Cursor, Claude y cualquier cliente MCP.

Búsqueda de deudas de alguaciles rusos para agentes de IA.

PyPI License: MIT MCP Python 3.11+

Cubre:

  • Personas físicas (por nombre completo + fecha de nacimiento).
  • Personas jurídicas (por INN-10 / OGRN-13).
  • Empresarios individuales (por INN-12 / OGRNIP-15).

Parte de la familia de servidores MCP atomno para due-diligence de contrapartes rusas: mcp-egrul (datos de personas jurídicas) · mcp-fns-check (solvencia fiscal) · mcp-cbr-rates (tasas del Banco Central) · mcp-fssp (deudas en FSSP).

Por qué

La API oficial de FSSP (api-ip.fssp.gov.ru) está deshabilitada desde el 10 de marzo de 2022 y no se planea restaurarla. El único punto oficial es el servicio web público fssp.gov.ru/iss/ip con CAPTCHA. Esto crea un nicho: un envoltorio MCP con soporte para varios proveedores comerciales (Damia / Checko / NewDB / api-cloud) y un modelo de datos normalizado.

Casos de uso principales:

  • Agente de IA en Cursor / Claude Desktop realiza due-diligence de una contraparte en el chat en 30 segundos en lugar de 10 minutos de navegación manual por el sitio de FSSP.
  • Abogados / bancos / scoring integran una única llamada check_*_debts en sus scripts de Python o 1C, sin analizar respuestas crudas de 3-4 proveedores diferentes.
  • Entusiastas del self-host instalan el cliente localmente con su propia clave Damia/Checko y trabajan sin depender de SaaS de terceros — elimina la paranoia sobre fugas de datos personales.

Inicio rápido

1. Instalar

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

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

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

2. Obtener una clave de proveedor

Al menos uno de:

3. Configuración

Crea .env en el directorio de trabajo (o pasa las variables a través de la configuración MCP):

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

Lista completa de variables — ver .env.example.

4. Conectar a Cursor

Abre ~/.cursor/mcp.json (o Settings → MCP) y añade:

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

Reinicia Cursor. Ahora el agente de IA puede llamar a fssp.check_individual_debts(...), fssp.check_legal_entity_debts(...) y fssp.get_proceeding_details(...).

5. Conectar a Claude Desktop

Abre claude_desktop_config.json y añade:

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

Herramientas disponibles

HerramientaPropósito
pingVerifica la disponibilidad del servidor y el proveedor actual.
check_individual_debts(fio, birth_date, region?)Lista de procedimientos de ejecución abiertos para una persona física.
check_legal_entity_debts(inn?, ogrn?)Lista de procedimientos de ejecución abiertos para una persona jurídica o empresario individual.
get_proceeding_details(proceeding_id)Ficha detallada de un procedimiento de ejecución por número.

En la versión Pro (Fase 3+, requiere ATOMNO_API_KEY):

  • summarize_debts(...) — resumen de deudas con IA, categorización y puntuación de riesgo.
  • monitor_debts_changes(...) — suscripción a cambios con alertas webhook/Telegram.

Variables de entorno

VariablePropósitoPredeterminado
MCP_FSSP_PROVIDERProveedor: damia / checko / newdb / api_cloud / self_parser / atomno_prodamia
MCP_FSSP_DAMIA_KEYClave de Damia API-FSSP—
MCP_FSSP_CHECKO_KEYClave de Checko v2—
MCP_FSSP_NEWDB_KEYClave de NewDB—
MCP_FSSP_API_CLOUD_KEYClave de api-cloud.ru—
ATOMNO_API_KEYClave del modo Pro (api.atomno-mcp.ru/fssp/)—
ATOMNO_API_BASEURL del backend Prohttps://api.atomno-mcp.ru/mcp-fssp/v1
MCP_FSSP_HTTP_TIMEOUTTiempo de espera de una consulta en segundos15
MCP_FSSP_RPSLímite de consultas por minuto desde el cliente30
MCP_FSSP_USER_AGENTUser-Agent para consultasmcp-fssp/0.1 (...)
MCP_FSSP_AUDIT_DBRuta al registro de auditoría SQLite./audit.sqlite
MCP_FSSP_LOG_LEVELNivel de registro: DEBUG/INFO/WARNING/ERRORINFO

Seguridad y datos personales

  • Los datos personales (nombre completo, fecha de nacimiento) no se guardan en texto plano. El registro de auditoría solo almacena sha256(fio_lower + birth_date).
  • Según 229-FZ art. 6.1, los datos del banco de procedimientos de ejecución son públicos y están disponibles sin consentimiento del deudor.
  • Sin embargo, cuando se usan con fines comerciales, el operador debe cumplir con 152-FZ. El uso con fines legales (por ejemplo, due-diligence antes de una transacción, scoring con consentimiento del prestatario) es responsabilidad del usuario.

Aviso legal

El servicio es un agregador e interfaz conveniente sobre datos públicos de FSSP (229-FZ art. 6.1). No está afiliado con FSSP de Rusia, Damia, Checko, NewDB, api-cloud ni otros proveedores. Se utiliza bajo su propio riesgo.

La información devuelta por las herramientas tiene carácter informativo y no reemplaza los documentos oficiales emitidos por FSSP. Los autores no responden por la actualidad, integridad ni exactitud de los datos de los proveedores. La responsabilidad por la legalidad del uso de la información (incluido el cumplimiento de 152-FZ al procesar datos personales) recae en el usuario.

Al tomar decisiones legalmente significativas (por ejemplo, rechazar un crédito), es necesario solicitar los documentos primarios al propio deudor o a través de canales oficiales (solicitud a la unidad de alguaciles).

Hoja de ruta

  • v0.1 (actual) — Fase 0 scaffold + proveedor Damia + check_individual_debts.
  • v0.2 — multi-proveedor (+Checko, NewDB, api-cloud), check_legal_entity_debts, get_proceeding_details, caché local L1.
  • v0.3+ — self_parser mediante solucionador de CAPTCHA.
  • v0.5 — integración con el backend Pro (api.atomno-mcp.ru/fssp/): summarize_debts, monitor_debts_changes, caché L2 por 30 días, respaldo entre 3 proveedores.

Documentación sobre herramientas y variables de entorno — en este README y en CHANGELOG.md. Tras la publicación — también en GitHub: atomno-mcp/mcp-fssp.

Licencia

MIT © 2026 atomno.

Backend Pro (atomno-mcp/mcp-fssp-server) — planificado para la Fase 2 (servicio alojado privado con licencia propietaria). El cliente abierto es totalmente funcional sin él — el usuario introduce su propia clave de cualquiera de los 4 proveedores comerciales.

Enlaces