TXGraph
cognis-digital/txgraph
Detecção de AML baseada em grafos: estruturação, layering e redes de mulas
Ver no GitHubMCP 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/txgraph1 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
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.
Fintech & Payments Security — PCI, fraud, AML, and payment rails.
pip install cognis-txgraph
txgraph scan . # → prioritized findings in seconds
Contents
- Why txgraph? · Features · Quick start · Example · Architecture · AI stack · How it compares · Integrations · Install anywhere · Related · Contributing
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 jsoninto 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 txgraph | AMLSim | |
|---|---|---|
| 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 | ✅ COCL | varies |
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
| Linux | macOS | Windows | Docker | Cloud |
|---|---|---|---|---|
scripts/setup-linux.sh | scripts/setup-macos.sh | scripts/setup-windows.ps1 | docker run ghcr.io/cognis-digital/txgraph | DEPLOY.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
txgraphsaved 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.