mcp-fssp

Consulta de dívidas do FSSP (Serviço Federal de Oficiais de Justiça) da Rússia via MCP — verifique processos de execução (исполнительные производства) para pessoas físicas e jurídicas diretamente do Cursor, Claude Desktop, Cl...

GitHubExperimente este MCPPatrocinado

Documentação

mcp-fssp

Servidor MCP do FSSP: consulta de processos de execução para pessoas físicas, empresas e empreendedores individuais — valores, status, dados do oficial de justiça e fundamento da cobrança. Conecta-se ao Cursor, Claude e a qualquer cliente MCP.

Consulta de dívidas de oficiais de justiça russos para agentes de IA.

PyPI License: MIT MCP Python 3.11+

Cobre:

  • Pessoas físicas (por nome completo + data de nascimento).
  • Pessoas jurídicas (por INN-10 / OGRN-13).
  • Empreendedores individuais (por INN-12 / OGRNIP-15).

Parte da família de servidores MCP atomno para due diligence de contrapartes russas: mcp-egrul (dados de pessoas jurídicas) · mcp-fns-check (conformidade fiscal) · mcp-cbr-rates (taxas do Banco Central) · mcp-fssp (dívidas no FSSP).

Por quê

A API oficial do FSSP (api-ip.fssp.gov.ru) está desativada desde 10 de março de 2022 e não há previsão de restauração. O único ponto oficial é o serviço web público fssp.gov.ru/iss/ip com CAPTCHA. Isso cria um nicho: um wrapper MCP com suporte a vários provedores comerciais (Damia / Checko / NewDB / api-cloud) e um modelo de dados normalizado.

Principais casos de uso:

  • Agente de IA no Cursor / Claude Desktop faz due diligence de uma contraparte no chat em 30 segundos, em vez de 10 minutos navegando manualmente pelo site do FSSP.
  • Advogados / bancos / scoring integram uma única chamada check_*_debts em seus scripts Python ou 1C, sem precisar interpretar respostas brutas de 3-4 provedores diferentes.
  • Entusiastas de self-host instalam o cliente localmente com sua própria chave Damia/Checko e trabalham sem depender de SaaS de terceiros — eliminando a preocupação com vazamento de dados pessoais.

Início rápido

1. Instalar

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

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

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

2. Obter uma chave de provedor

Pelo menos um dos seguintes:

3. Configuração

Crie .env no diretório de trabalho (ou passe as variáveis pelo config do MCP):

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

Lista completa de variáveis — veja .env.example.

4. Conectar ao Cursor

Abra ~/.cursor/mcp.json (ou Settings → MCP) e adicione:

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

Reinicie o Cursor. Agora o agente de IA pode chamar fssp.check_individual_debts(...), fssp.check_legal_entity_debts(...) e fssp.get_proceeding_details(...).

5. Conectar ao Claude Desktop

Abra claude_desktop_config.json e adicione:

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

Ferramentas disponíveis

FerramentaFinalidade
pingVerifica a prontidão do servidor e o provedor atual.
check_individual_debts(fio, birth_date, region?)Lista de processos de execução abertos para pessoa física.
check_legal_entity_debts(inn?, ogrn?)Lista de processos de execução abertos para pessoa jurídica ou empreendedor individual.
get_proceeding_details(proceeding_id)Ficha detalhada de um processo de execução por número.

Na versão Pro (Fase 3+, requer ATOMNO_API_KEY):

  • summarize_debts(...) — resumo de dívidas com IA, categorização e score de risco.
  • monitor_debts_changes(...) — assinatura de alterações com alertas via webhook/Telegram.

Variáveis de ambiente

VariávelFinalidadePadrão
MCP_FSSP_PROVIDERProvedor: damia / checko / newdb / api_cloud / self_parser / atomno_prodamia
MCP_FSSP_DAMIA_KEYChave Damia API-FSSP—
MCP_FSSP_CHECKO_KEYChave Checko v2—
MCP_FSSP_NEWDB_KEYChave NewDB—
MCP_FSSP_API_CLOUD_KEYChave api-cloud.ru—
ATOMNO_API_KEYChave do modo Pro (api.atomno-mcp.ru/fssp/)—
ATOMNO_API_BASEURL do backend Prohttps://api.atomno-mcp.ru/mcp-fssp/v1
MCP_FSSP_HTTP_TIMEOUTTimeout de uma requisição em segundos15
MCP_FSSP_RPSLimite de requisições por minuto do cliente30
MCP_FSSP_USER_AGENTUser-Agent para requisiçõesmcp-fssp/0.1 (...)
MCP_FSSP_AUDIT_DBCaminho para o log de auditoria SQLite./audit.sqlite
MCP_FSSP_LOG_LEVELNível de log: DEBUG/INFO/WARNING/ERRORINFO

Segurança e dados pessoais

  • Dados pessoais (nome completo, data de nascimento) não são armazenados em texto puro. O log de auditoria guarda apenas sha256(fio_lower + birth_date).
  • Conforme 229-FZ art. 6.1, as informações do banco de dados de processos de execução são públicas e acessíveis sem consentimento do devedor.
  • No entanto, ao usar para fins comerciais, o operador deve cumprir o 152-FZ. O uso para fins legítimos (por exemplo, due diligence antes de uma transação, scoring com consentimento do tomador) é de responsabilidade do usuário.

Aviso legal

O serviço é um agregador e interface conveniente sobre dados públicos do FSSP (229-FZ art. 6.1). Não é afiliado ao FSSP da Rússia, Damia, Checko, NewDB, api-cloud ou outros provedores. O uso é por sua conta e risco.

As informações retornadas pelas ferramentas têm caráter meramente informativo e não substituem documentos oficiais emitidos pelo FSSP. Os autores não se responsabilizam pela atualidade, completude ou precisão dos dados dos provedores. A responsabilidade pela legalidade do uso das informações (incluindo o cumprimento do 152-FZ no tratamento de dados pessoais) é do usuário.

Ao tomar decisões juridicamente relevantes (por exemplo, recusa de crédito), é necessário solicitar documentos primários ao próprio devedor ou por canais oficiais (solicitação à unidade de oficiais de justiça).

Roadmap

  • v0.1 (atual) — Fase 0 scaffold + provedor Damia + check_individual_debts.
  • v0.2 — multi-provedor (+Checko, NewDB, api-cloud), check_legal_entity_debts, get_proceeding_details, cache local L1.
  • v0.3+ — self_parser via resolvedor de CAPTCHA.
  • v0.5 — integração com o backend Pro (api.atomno-mcp.ru/fssp/): summarize_debts, monitor_debts_changes, cache L2 por 30 dias, fallback entre 3 provedores.

Documentação sobre ferramentas e variáveis de ambiente — neste README e em CHANGELOG.md. Após a publicação — também no GitHub: atomno-mcp/mcp-fssp.

Licença

MIT © 2026 atomno.

Backend Pro (atomno-mcp/mcp-fssp-server) — planejado para a Fase 2 (serviço hospedado privado com licença proprietária). O cliente aberto é totalmente funcional sem ele — o usuário insere sua própria chave de qualquer um dos 4 provedores comerciais.

Links