convez.ai
MCP ServerFinanceiroAvançado
cognis-digital

TXGraph

cognis-digital/txgraph

Detecção de AML baseada em grafos: estruturação, layering e redes de mulas

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que constrói grafos de transações a partir de dados de ledger/conta e identifica padrões de estruturação, camadas e redes de mulas para triagem AML. Oferece detecção de suspeita de lavagem de dinheiro em formato pronto para SAR (Suspicious Activity Report) via CLI scriptável ou como ferramenta nativa de agentes.

Instalação

$npx convez-ai cognis-digital/txgraph

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise de padrões de transações suspeitas para compliance AML
  • Identificação de redes de mulas e estruturação de valores em instituições financeiras
  • Automação de triagem e geração de relatórios SAR
  • Integração em pipelines CI/CD para gates de risco em operações de pagamento

Veredito

Ferramenta especializada de alto valor para AML/compliance em fintechs. Implementação pronta e autocontida com suporte MCP nativo, mas exige contexto de segurança financeira para aproveitar plenamente seus padrões de detecção.

README

A tradução para o português deste README ainda está na fila.

TXGRAPH

Builds a transaction graph from ledger/account data and surfaces structuring, layering, and mule-network patterns for AML triage.

PyPI CI License: COCL 1.0 Suite

Fintech & Payments Security — PCI, fraud, AML, and payment rails.

pip install cognis-txgraph
txgraph scan .            # → prioritized findings in seconds

Contents

Why txgraph?

Graph-based money-laundering detection is academically hot but has no plug-and-play CLI; ingest CSV, emit suspicious subgraphs + SAR-ready summaries with zero infra is a viral AML demo.

txgraph is single-purpose, scriptable, and self-hostable: point it at a target, get prioritized results in the format your workflow already speaks (table · JSON · SARIF), gate CI on it, and let agents drive it over MCP.

Features

  • ✅ Load Transactions
  • ✅ Build Graph
  • ✅ Detect Structuring
  • ✅ Detect Layering
  • ✅ Detect Mules
  • ✅ Analyze
  • ✅ Sar Summary
  • ✅ Runs on Linux/macOS/Windows · Docker · devcontainer
  • ✅ Ports in Python, JavaScript, Go, and Rust (ports/)

Quick start

pip install cognis-txgraph
txgraph --version
txgraph scan .                       # scan current project
txgraph scan . --format json         # machine-readable
txgraph scan . --fail-on high        # CI gate (non-zero exit)

Example

$ txgraph scan .
  [HIGH    ] TXG-001  example finding             (./src/app.py)
  [MEDIUM  ] TXG-002  another signal              (./config.yaml)

  2 findings · risk score 5 · 38ms

Architecture

flowchart LR
  A[Input: file / dir / API] --> B[Collectors]
  B --> C[Rules / Analyzers]
  C --> D[Scorer]
  D --> E{Reporters}
  E --> F[Table]
  E --> G[JSON / SARIF]
  E --> H[MCP tool -. drives .-> AI agents]

Use it from any AI stack

txgraph is interoperable with every popular way of using AI:

  • MCP server — txgraph mcp (Claude Desktop, Cursor, Cognis.Studio, uncensored-fleet)
  • OpenAI-compatible / JSON — pipe txgraph scan . --format json into any agent or LLM
  • LangChain · CrewAI · AutoGen · LlamaIndex — wrap the CLI/JSON as a tool in one line
  • CI / scripts — exit codes + SARIF for non-AI pipelines

How it compares

Cognis txgraphAMLSim
Self-hostable, no account✅varies
Single command, zero config✅⚠️
JSON + SARIF for CI✅varies
MCP-native (AI agents)✅❌
Polyglot ports (JS/Go/Rust)✅❌
Open license✅ COCLvaries

Built in the spirit of AMLSim / Neo4j fraud graph, re-framed the Cognis way. Missing a credit? Open a PR.

Integrations

Pipes into your stack: SARIF for code-scanning, JSON for anything, an MCP server (txgraph mcp) for AI agents, and a webhook forwarder for SIEM/Slack/Jira. See docs/INTEGRATIONS.md.

Install — every way, every platform

pip install "git+https://github.com/cognis-digital/txgraph.git"    # pip (works today)
pipx install "git+https://github.com/cognis-digital/txgraph.git"   # isolated CLI
uv tool install "git+https://github.com/cognis-digital/txgraph.git" # uv
pip install cognis-txgraph                                          # PyPI (when published)
docker run --rm ghcr.io/cognis-digital/txgraph:latest --help        # Docker
brew install cognis-digital/tap/txgraph                             # Homebrew tap
curl -fsSL https://raw.githubusercontent.com/cognis-digital/txgraph/main/install.sh | sh
LinuxmacOSWindowsDockerCloud
scripts/setup-linux.shscripts/setup-macos.shscripts/setup-windows.ps1docker run ghcr.io/cognis-digital/txgraphDEPLOY.md (AWS/Azure/GCP/k8s)

Related Cognis tools

  • panhound — Scans code, logs, fixtures, and S3 buckets for leaked PANs (Luhn-validated card numbers) and CVVs before they hit prod.
  • fraudlens — Replays a stream of transactions against pluggable fraud rules and ML scorers, emitting precision/recall and alert volume from the terminal.
  • obscan — Conformance and security linter for Open Banking / FAPI APIs: validates OAuth flows, consent scopes, and PSD2 endpoints against the spec.
  • ledgerproof — Verifies double-entry ledger integrity and tamper-evidence by checking balance invariants and hash-chained journal entries.
  • iso20022 — Validates, lints, and diffs ISO 20022 / pacs / camt payment messages and translates legacy MT into MX with schema-aware errors.
  • tokenvault — Self-hostable PCI tokenization microservice and CLI that swaps PANs for format-preserving tokens and proves no raw card data persists.

Explore the suite → 🗂️ all 170+ tools · ⭐ awesome-cognis · 🔗 cognis-sources · 🤖 uncensored-fleet · 🧠 hermes

Contributing

PRs, new rules, and demo scenarios are welcome under the collaboration-pull model — see CONTRIBUTING.md and SECURITY.md.

⭐ If txgraph saved you time, star it — it genuinely helps others find it.

License

Source-available under the Cognis Open Collaboration License (COCL) v1.0 — free for personal, internal-evaluation, research, and educational use; commercial / production use requires a license (licensing@cognis.digital). See LICENSE.


Ver o original no GitHub

Bom para

Relacionados