Skip to content
Conduit

mcp server

flame-exchange

Open-source fraud intelligence exchange: 86 threat paths, 141 fraud types, and 36 baselines mapped across 7 frameworks — with STIX 2.1, MISP, TAXII exports and an MCP server for AI-assisted analysis.

elchacal801/flame-exchangecommunitylistedunreviewed

Set up

Runs on your computer. Pick your agent and operating system.

This project does not publish an install method we can turn into a config. Follow the README instead.

README

synced Oct 25, 2026

Build & Deploy License: MIT Python 3.10+ Threat Paths Detection Rules STIX 2.1 MCP Server

FLAME -- Fraud Lifecycle Analysis & Mitigation Exchange

The open-source fraud intelligence exchange. Cross-mapping the world's fraud taxonomies into one library.

FLAME is an open-source, community-driven exchange for structured fraud intelligence. It cross-maps 7 fraud frameworks into a unified taxonomy of threat paths, baselines, and emulation playbooks -- browsable through a zero-dependency web interface with D3-powered visualizations, AI-assisted intake, and an MCP server for conversational fraud intelligence. Exports to STIX 2.1, MISP, TAXII, Sigma, and CQL are built in.

Explore FLAME Live →


At a Glance

MetricCount
Threat Paths91 (TP-0001 -- TP-0091)
Fraud Families11 (ATT&CK-style matrix taxonomy)
Detection Logic Rules221 in flame-detections
Baselines36 (48/91 TPs linked via baseline_ids)
Emulation Playbooks14 adversary simulation scripts
Fraud Types144 in master taxonomy
Sectors Covered24
Framework Cross-Mappings7 (CFPF, ATT&CK, MITRE F3, Group-IB FM, Stripe FT3, UCFF, Regulatory)
Regulatory Requirements31 across 7 jurisdictions
Export Formats5 (STIX, MISP, TAXII, RSS, JSON API)
MCP Server Tools6
CI/CD Workflows7
Tests217 (pytest)

Why FLAME Exists

Between April 2025 and April 2026, six organizations independently concluded that fraud needs structured taxonomy frameworks. Stripe published FT3 (then abandoned it). MITRE shipped F3 (April 2026). Group-IB released Fraud Matrix 2.0 (commercially gated). FS-ISAC assembled 300+ members for the Cyber Fraud Prevention Framework. The taxonomy layer is converging. The community knowledge exchange layer remains entirely unserved in open source.

CapabilityFLAMEGroup-IB FM 2.0FS-ISAC CFPFStripe FT3MITRE F3
Open sourceYesNoPaper onlyAbandonedYes
Community contributedYesNoNo platformNoYes
Structured detection logic221 rulesMobile-heavyNoNoNo
Multi-taxonomy mapping7 frameworksOwn onlyOwn onlyOwn onlyATT&CK only
TIP interop (STIX/MISP/TAXII)YesNoNoNoNo
AI-assisted intakeYesNoNoNoNo

Taxonomies define the language. FLAME is where practitioners share what actually works.

* Detection rules are migrating to flame-detections for independent quality and contribution cadence.

The ACAMS International Anti-Fraud and Technology Task Force confirmed in March 2026 that cross-sector fraud intelligence sharing is the #1 industry priority — yet remains systemically blocked by siloed data, incompatible formats, and lack of structured typologies. FLAME directly addresses each of these barriers through open-source structured threat paths, standardized exports (STIX/MISP/TAXII/Sigma), and a common taxonomy spanning 144 fraud types across 24 sectors.


Supported Frameworks

FrameworkStatus
FS-ISAC Cyber Fraud Prevention Framework (CFPF)Primary structure -- all 91 TPs mapped
MITRE ATT&CKSupplementary mapping where applicable
MITRE F3 (Fight Fraud Framework)Mapped (91/91 TPs) via f3_mapper.py -- shipped April 2026, full coverage August 2026
Group-IB Fraud Matrix 2.0Cross-reference mapping (stage names)
Stripe FT3Mapped (91/91 TPs) via ft3_mapper.py
Group-IB UCFFDefense-side maturity alignment (7 domains)

What FLAME is not: FLAME is not a taxonomy project. It is a knowledge exchange that sits on top of existing taxonomies, providing the operational intelligence -- threat paths, detection queries, investigation playbooks, and cross-team correlation guidance -- that no taxonomy alone delivers.


Architecture

FLAME follows a markdown-first, database-derived architecture modeled on HEARTH by the THOR Collective.

  • Markdown is the source of truth. Threat paths, baselines, and detection rules are authored as structured files with YAML frontmatter including fraud_family, primary_phase, and short_name for matrix classification. Detection rules currently live in this repo but are migrating to flame-detections for independent quality and contribution cadence.
  • The database is derived. Python scripts parse the source files, build a SQLite index, and export JSON for the frontend.
  • The frontend is static. Vanilla HTML/CSS/JS served via GitHub Pages. No build step, no framework dependencies.
  • Exports are standard. Build-time pipelines produce STIX 2.1, MISP, TAXII 2.1, Sigma, and RSS artifacts.
  • CI/CD is automated. GitHub Actions validate submissions, rebuild the database, and regenerate all exports on merge.

Data Flow

graph LR
    subgraph Sources
        TP["ThreatPaths/*.md"]
        DL["flame-detections repo"]
        BL["Baselines/*.md"]
        EP["EmulationPlaybooks/*.json"]
    end

    subgraph Build
        BD["build_database.py"]
        EX_STIX["export_flame_stix.py"]
        EX_MISP["export_misp.py"]
        EX_TAXII["export_taxii.py"]
        EX_SIGMA["flame-detections CI"]
    end

    subgraph Artifacts
        DB["SQLite + JSON Index"]
        STIX["STIX 2.1 Bundle"]
        MISP_OUT["MISP Galaxy + Feed"]
        TAXII_OUT["TAXII 2.1 Endpoints"]
        SIGMA_OUT["Sigma Packs"]
        RSS["RSS Feed"]
        API["JSON API v1"]
    end

    subgraph Consumers
        SPA["Web Frontend"]
        MCP["MCP Server"]
        TIP["TIP Integration"]
    end

    TP & DL & BL & EP --> BD
    BD --> DB & RSS & API
    BD --> EX_STIX --> STIX
    BD --> EX_MISP --> MISP_OUT
    BD --> EX_TAXII --> TAXII_OUT
    BD --> EX_SIGMA --> SIGMA_OUT
    DB & API --> SPA
    DB --> MCP
    STIX & MISP_OUT & TAXII_OUT --> TIP

CI/CD Pipeline

graph TD
    PR[Pull Request] --> VAL[validate-pr.yml]
    VAL -- Merge --> BUILD[build-and-deploy.yml]
    BUILD --> PAGES[GitHub Pages]
    ISSUE[Intel Submission Issue] --> AI[ai-intake.yml]
    AI --> GEN[generate_threat_path.yml]
    GEN --> PR
    CRON[Cron 2x Daily] --> REG[fetch-regulatory.yml]
    REG --> DBUP[update-database.yml]
    LABEL[Label: submitted] --> PEER[peer-review.yml]
    PEER --> PR

Repository Structure

ThreatPaths/           91 fraud scheme lifecycle mappings (TP-XXXX.md)
                       (Detection rules now in flame-detections repo)
Baselines/             36 environmental profiling benchmarks (BL-XXXX.md)
EmulationPlaybooks/    14 adversary simulation playbooks (EP-XXXX.json)
Templates/             Submission templates (TP, DL, BL, EP)
config/                Regulatory requirements and source configs
scripts/               Build, validation, and export scripts (22 modules)
  regulatory/          6-source regulatory data fetchers
mcp_server/            MCP server exposing 6 fraud intelligence tools
tests/                 251 tests across pytest test modules
database/              Generated artifacts (auto-built by CI)
  flame-index.json           Metadata-only index (fast frontend load)
  flame-content/             Individual TP content files (lazy-loaded)
  flame-stats.json           Pre-computed aggregate statistics
  flame-contributors.json    Contributor leaderboard data
  flame_stix_bundle.json     STIX 2.1 bundle with fraud extensions
                             (Detection exports now in flame-detections repo)
  misp-feed/                 Per-TP MISP event files + manifest
  regulatory-alerts.json     Automated regulatory alert feed (6 sources)
  feed.xml                   RSS 2.0 feed
data/                  Taxonomies, framework mappings, MISP galaxy defs
api/
  v1/                  Static JSON API endpoints
  taxii/               TAXII 2.1 discovery, collections, objects
docs/                  Project documentation and specifications
.github/
  workflows/           7 CI/CD workflows
  ISSUE_TEMPLATE/      5 issue templates for submissions

Threat Path Collection

FLAME ships with 91 threat paths covering 144 fraud types across 24 sectors.

IDSchemeKey Fraud Types
TP-0001Treasury Management ATO via MalvertisingATO, vishing, wire fraud
TP-0002BEC -- Vendor Impersonation Wire FraudBEC, invoice fraud
TP-0003Synthetic Identity -- Credit Card Bust-OutSynthetic identity, application fraud
TP-0004Payroll Diversion via HR Portal CompromisePayroll diversion, BEC
TP-0005Insurance Premium Diversion via Agent Portal ATOATO, premium diversion
TP-0006Real Estate Wire Fraud -- Closing ScamBEC, wire fraud
TP-0007Deepfake Voice Authorization for Wire TransferDeepfake, impersonation
TP-0008SIM Swap to Cryptocurrency Exchange ATOATO, crypto laundering
TP-0009Check Washing and Fraudulent Mobile DepositCheck fraud
TP-0010Disability Insurance FraudFraudulent claims

Recently Added

IDSchemeKey Fraud Types
TP-0051QR Code Payment Fraud / Quishingquishing, credential-stuffing, account-takeover
TP-0052Sextortion-Investment Hybrid Fraudsextortion, investment-scam, deepfake
TP-0053Vehicle Export Financing Fraudvehicle-export-fraud, identity-theft, application-fraud
TP-0054Fraud-as-a-Service (FaaS) Platformsfraud-as-a-service, AI infrastructure, phishing
TP-0055Crypto Fraud-Terrorism/Narco Financing Nexuscrypto-laundering, investment-scam, state-criminal convergence
TP-0056Insurance Claims Fraud (Motor/Medical)insurance-fraud, fraudulent-claim, identity-theft
TP-0057Deepfake-as-a-Service Marketplace Ecosystemdeepfake-as-a-service, deepfake-fraud, AI face/voice changer
TP-0058Scam Compound Operational Infrastructurescam-compound-operations, chatbot-enabled-fraud, social-engineering
TP-0059Automated Mule Account Infrastructureautomated-mule-accounts, money-laundering, bot-driven-account-opening
TP-0060Investment Fraud TDS Pipelinetraffic-distribution-system, investment-fraud, cloaking
TP-0061Threat Actor Enabling Bulletproof Hosting Infrastructurebulletproof-hosting, fraud-enabling-infrastructure, hosting-provider-complicity
TP-0062Recovery Fraud -- Double-Dip Re-victimizationrecovery-fraud, impersonation, advance-fee-fraud
TP-0063Organized Counterfeit Goods and Non-Delivery Fraud Networkspurchase-scam, auction-fraud, brand-impersonation
TP-0064Long-Firm and Organized Business Credit Fraudlong-firm-fraud, bust-out, application-fraud
TP-0065Organized Mass-Marketing Fraud Infrastructurerobodialling-fraud, vishing, social-engineering
TP-0066Crash-for-Cash and Organized Insurance Fraud Ringscrash-for-cash, insurance-fraud, collusion
TP-0067AiTM Phishing Kit Infrastructure and Session Token Hijackingaitm-phishing, account-takeover, fraud-as-a-service
TP-0068Gift Card Fraud Lifecycle — Generation, Tampering, and Monetizationgift-card-fraud, gift-card-tampering, loyalty-point-fraud
TP-0069Smishing PhaaS Ecosystem — Darcula, Smishing Triadsmishing, card-not-present-fraud, fraud-as-a-service
TP-0070Travel Booking Fraud & Fake OTA Networkstravel-booking-fraud, buy-for-you-fraud, fake-ota
TP-0071IRSF & Telecom Revenue Share Fraudirsf, premium-rate-fraud, wangiri
TP-0072Telecom Subscription & Billing Fraudsubscription-fraud, telecom-billing-fraud
TP-0073Real Estate Title Fraud & Deed Thefttitle-fraud, deed-theft, seller-impersonation
TP-0074Ghost Broking & Unauthorized Insurance Portalsghost-broking, ghost-portal, unlicensed-insurance
TP-0075Friendly Fraud & Chargeback Abusefriendly-fraud, chargeback-abuse, dispute-fraud
TP-0076Affiliate Network Fraud & Invalid Trafficaffiliate-fraud, click-fraud, cookie-stuffing
TP-0077AI-Generated Insurance Claims Fraudai-generated-claims, deepfake-claims, document-fraud
TP-0078Stablecoin Laundering via CEX Hot Wallet Pipelinescrypto-laundering, stablecoin-laundering, money-laundering
TP-0079Cheap gTLD and PaaS Subdomain Abuse for Fraud Infrastructurephishing, brand-impersonation, paas-subdomain-abuse
TP-0080Stablecoin Freeze-Evasion via Wrapped Tokens & Cross-Chain Bridgesstablecoin-freeze-evasion, crypto-laundering, sanctions-evasion
TP-0081Vishing-Led Identity Abuse and Hybrid Social Engineeringvishing, account-takeover, fake-captcha-fraud
TP-0082Gold Courier Scam — Physical Precious Metal Cash-Outsocial-engineering, impersonation, elder-exploitation
TP-0083Investment Club Scam — Social Media Insider Group Fraudinvestment-scam, social-engineering, crypto-laundering
TP-0084Government Impersonation — Authority-Based APP Fraudimpersonation, authorized-push-payment, elder-exploitation
TP-0085Crypto ATM/Kiosk Directed Fraud — Physical-to-Digital Monetizationcrypto-laundering, authorized-push-payment, elder-exploitation
TP-0086Crisis-Exploitation Domain Intelligence — Oil Shock Infrastructurecrisis-exploitation, phishing, fraud-enabling-infrastructure
TP-0087Infostealer-to-Fraud Pipeline — MaaS Credential Harvestingcredential-harvesting, account-takeover, fraud-as-a-service
TP-0088Logistics Sector Spearphishing — Carrier Impersonationphishing, brand-impersonation, credential-harvesting
TP-0089TAE Upstream Transit Provider Complicitybulletproof-hosting, fraud-enabling-infrastructure, hosting-provider-complicity
TP-0090Phantom Hacker — Layered Impostor Account Drainphantom-hacker, tech-support-scam, elder-exploitation
TP-0091Agentic AI Fraud Automationagentic-ai-fraud, account-takeover, credential-stuffing
IDSchemeKey Fraud Types
TP-0011Romance Scam to Money Mule RecruitmentRomance scam, money mule
TP-0012APP Fraud -- Tech Support / Bank ImpersonationVishing, impersonation
TP-0013Credential Stuffing to Loyalty Point DrainCredential stuffing, ATO
TP-0014Insider-Enabled Account FraudInsider threat, collusion
TP-0015Employment Fraud via Brand ImpersonationJob scam, identity theft
TP-0016First-Party Fraud (Bust-Out)Bust-out, first-party fraud
TP-0017Pig Butchering (Investment Scam)Investment scam, romance scam
TP-0018Deepfake Document FraudDeepfake fraud, documentary fraud
TP-0019Business Identity TheftIdentity theft, application fraud
TP-0020Supply Chain Payment FraudBEC, vendor impersonation
TP-0021Healthcare Provider Billing FraudHealthcare fraud, phantom billing
TP-0022Government Program FraudBenefit fraud, tax fraud
TP-0023Mobile Banking Trojan / Overlay AttackMalware, ATO
TP-0024A2A Instant Payment Fraud (Zelle/FedNow/Pix)APP, unauthorized transaction
TP-0025GenAI-Enhanced APP Fraud -- Romance VariantRomance scam, deepfake
TP-0026GenAI-Enhanced APP Fraud -- Investment VariantInvestment scam, deepfake
TP-0027Elder Financial ExploitationSocial engineering, APP
TP-0028DME Phantom Billing (Medicare Fraud)Healthcare fraud, phantom billing
TP-0029AI Synthetic Identity & Document ForgerySynthetic identity, deepfake fraud
TP-0030E-Commerce Triangulation FraudPayment diversion, identity theft
TP-0031Refund-as-a-Service (FTID / RaaS)Refunding-as-a-service
TP-0032Web3 Wallet Drainer / Approval PhishingApproval phishing, crypto laundering
TP-0033Ghost Student Financial Aid BotnetsGhost student fraud, application fraud
TP-0034DPRK State-Sponsored IT Worker FraudDPRK IT worker fraud, data theft
TP-0035Magecart E-Skimmer Data CompromiseE-skimmer, data theft
TP-0036Purchase Scam Merchant NetworksPurchase scam, brand impersonation
TP-0037Digital Wallet Fraud & NFC Relay AttacksDigital wallet fraud, NFC relay
TP-0038Card Testing Infrastructure AbuseCard testing, identity theft
TP-0039Agentic Commerce FraudAutonomous AI fraud, unauthorized transaction
TP-0040BNPL Multi-Provider FraudBNPL fraud, synthetic stacking
TP-0041RDGA-Based Infrastructure CampaignsRDGA infrastructure
TP-0042TDS Chain ExploitationTDS exploitation, malvertising, phishing
TP-0043AI-Accelerated Fraud Infrastructure GenerationAI infrastructure, phishing, brand impersonation
TP-0044State-Criminal Infrastructure ConvergenceState-criminal convergence, crypto laundering
TP-0045Sanctions Evasion via Fraud InfrastructureSanctions evasion, crypto laundering
TP-0046Geopolitically-Timed Fraud CampaignsState-criminal convergence
TP-0047Human Trafficking-Linked Fraud InfrastructureHuman trafficking facilitation, scam compounds
TP-0048Bulletproof Hosting Migration PatternsBPH migration, sanctions evasion
TP-0049Cryptocurrency Laundering InfrastructureCrypto laundering infrastructure, CMLN operations
TP-0050Calendar/Invite Injection PhishingCalendar phishing, social engineering

See ThreatPaths/INDEX.md for full cross-reference tables with sector, CFPF phase, and framework mappings.


Detection Rules and FLAME

Detection rules are maintained in the flame-detections sibling repo. The collection includes 221 rules — 98 pure Sigma-compatible (auto-convert to SPL, EQL, KQL) and 123 requiring hand-written native queries (CQL, SPL) for stateful correlation.

Detection rules are migrating to flame-detections in v1.0. This decoupling allows the detection content to evolve on its own quality bar and contribution cadence, separate from the core exchange taxonomy.

During migration, detection rules remain fully functional in this repo.

Audit tooling: scripts/audit_queries.py validates detection rule coverage and query correctness across the full TP inventory. scripts/sync_tp_rules.py synchronizes threat path rule references with actual detection logic files.


Emulation Playbooks

FLAME includes 14 adversary emulation playbooks -- CFPF phase-mapped simulation scripts for testing detection coverage against specific fraud schemes.

IDPlaybookLinked TPs
EP-0001Synthetic Identity Bust-OutTP-0003, TP-0016
EP-0002BEC Wire FraudTP-0002, TP-0006
EP-0003SIM Swap Crypto ATOTP-0008
EP-0004APP FraudTP-0012, TP-0024
EP-0005A2A Payment ExploitationTP-0024
EP-0006RDGA Campaign SimulationTP-0041
EP-0007TDS Chain Exploitation SimulationTP-0042
EP-0008Treasury Management ATOTP-0001
EP-0009Deepfake Voice AuthorizationTP-0007
EP-0010First-Party Fraud Bust-OutTP-0016
EP-0011Pig Butchering Romance/InvestmentTP-0017
EP-0012DPRK IT Worker InfiltrationTP-0034
EP-0013Agentic Commerce FraudTP-0039
EP-0014BNPL Multi-Provider StackingTP-0040

Playbooks follow a structured JSON schema with execution steps mapped to CFPF phases (P1--P5), cross-references to detection rules (DL-XXXX), and testability scoring. See Templates/emulation-playbook-template.json for the schema.


Frontend & Visualizations

The FLAME frontend is a vanilla HTML/CSS/JS single-page application with a dark theme, responsive design, and no build step. The default browse experience is an ATT&CK-style matrix view organizing all 91 threat paths by 11 fraud families (rows) and 5 CFPF phases (columns), with sector tab filtering and scannable short-name chips with confidence-colored borders. A card grid view is available as an alternative toggle.

Threat Path Matrix

The matrix view provides instant visual taxonomy of the fraud landscape:

  • 11 fraud family rows: Account Takeover, Payment & Wire, Social Engineering, Identity & Synthetic, Investment & Romance, Insurance & Healthcare, Crypto & Laundering, Fraud Infrastructure & FaaS, Retail & E-Commerce, State-Linked & Geopolitical, Telecom & Specialized
  • 5 CFPF phase columns: P1 Recon, P2 Initial Access, P3 Positioning, P4 Execution, P5 Monetization
  • Sector tabs filter TPs to Banking, Crypto, Insurance, Payments, Retail, and 19 more sectors
  • Short-name chips display curated labels (e.g., "Pig Butchering", "BEC Wire", "RDGA Domains") with confidence-colored left borders (green/amber/red)
  • Matrix/Grid toggle switches between matrix and card grid browse modes

D3 Visualizations

VisualizationDescription
Attack Flow DiagramHorizontal CFPF phase flow (P1--P5) per threat path with MITRE technique cards and detection rule badges
Ego Neighborhood GraphForce-directed 1--2 hop subgraph showing related threat paths with typed relationships
Global Relationship GraphFull-network force layout of all 91 TPs, sector-clustered with 7 color-coded relationship types
UCFF Radar Chart7-axis maturity profile for the UCFF self-assessment
Coverage Heat MapFraud type x CFPF phase coverage matrix with intensity-based coloring
Framework NavigatorCross-framework coverage grid (CFPF, MITRE ATT&CK, MITRE F3, Group-IB, FT3) with SVG and ATT&CK Navigator JSON export

Interactive Tools

ToolDescription
UCFF Self-AssessmentMaturity sliders across 7 governance domains with gap analysis and JSON import/export
Coverage AssessmentSector-specific fraud coverage analysis with phase weakness detection and gap scoring
Regulatory PulseLive feed from 6 regulatory sources (OFAC, FinCEN, SEC, OCC, FBI IC3, CFPB) with pagination and source filtering
Contributor LeaderboardRanked contributor table (TPs, DL rules, baselines, EPs) extracted from submission frontmatter

Additional Features

  • Matrix/Grid browse toggle -- ATT&CK-style matrix as default, card grid as alternative
  • Sector tab filtering -- filter matrix by any of 24 sectors with live TP counts
  • Full-text search via lunr.js with wildcard fallback
  • Multi-criteria filtering by CFPF phase, sector, and fraud type
  • Lazy content loading -- metadata index loads first, TP content on demand
  • Taxonomy toggle -- switch between CFPF, MITRE ATT&CK, and Group-IB views in detail
  • Hash-based routing -- deep links via #detail/TP-XXXX
  • Copy-to-clipboard on all code blocks
  • Mobile responsive with collapsible filter panel and horizontally scrollable matrix

Ecosystem Integration

STIX 2.1 Fraud Extension

4 custom SDOs extending STIX 2.1 for fraud intelligence:

  • x-flame-fraud-scheme -- Fraud lifecycle pattern (one per TP)
  • x-flame-financial-transaction -- Fraudulent money movement pattern
  • x-flame-mule-network -- Money mule infrastructure
  • x-flame-fraud-actor-profile -- Threat actor profiling

5 fraud-specific relationship types. Deterministic STIX IDs (UUID5) ensure reproducible builds. See STIX-FRAUD-EXTENSION.md for the full specification.

MISP Galaxy & Feed

A subscribable MISP galaxy with 91 cluster entries cross-referenced to MITRE ATT&CK, plus a per-TP event feed at database/misp-feed/. Point your MISP instance feed URL to database/misp-feed/manifest.json on the GitHub Pages site.

TAXII 2.1 Endpoints

Static TAXII 2.1-compatible files at api/taxii/ with 3 collections:

  1. Threat paths (as attack-pattern SDOs)
  2. Detection rules (as course-of-action SDOs)
  3. Baselines (linked to TPs via baseline_ids for benchmarking)

Compatible with MISP, OpenCTI, ThreatConnect, and other TIPs. Configure your TIP with the TAXII root at api/taxii/discovery.json.

Sigma Detection Packs

221 detection rules exported to Splunk SPL, Elasticsearch EQL, Microsoft Sentinel KQL, and CrowdStrike CQL. Detection packs are now maintained in flame-detections.

RSS Feed

Auto-generated RSS 2.0 feed at database/feed.xml with threat paths. Auto-discovery enabled in index.html.

Static JSON API

RESTful JSON endpoints at api/v1/:

GET /threat-paths.json              All TPs with metadata
GET /threat-paths/TP-XXXX.json      Individual TP details
GET /baselines.json                 All baselines
GET /coverage-matrix.json           Coverage analysis matrix
GET /stats.json                     Aggregate statistics
GET /taxonomy.json                  Master taxonomy

Regulatory Compliance

31 regulations across 7 jurisdictions (EU, UK, US, Singapore, Australia, Africa, International) mapped to relevant threat paths via regulatory_refs frontmatter. Includes PSD3 SCA, UK PSR APP, FinCEN AML/BSA, FATF R16, FATF Stablecoins 2026, MAS SRF, FFIEC Auth, DORA, UNODC Organized Fraud, STIX-FCI, MITRE F3, EBA Fraud Taxonomy v5.0, NRF Retail Fraud Taxonomy, CrowdStrike GTR 2026, World Cybercrime Index, and more.

Automated regulatory intelligence fetched 2x daily from 6 government sources:

SourceAgency
OFACTreasury Dept -- Sanctions List
FinCENFinancial Crimes Enforcement Network
SECSecurities and Exchange Commission
OCCOffice of the Comptroller of the Currency
FBI IC3Internet Crime Complaint Center
CFPBConsumer Financial Protection Bureau

MCP Server

FLAME includes a Model Context Protocol (MCP) server that exposes fraud intelligence through 6 tools, enabling AI assistants like Claude to query threat paths, framework mappings, and coverage assessments conversationally.

ToolDescription
search_threat_pathsSearch by keyword, sector, fraud type, CFPF phase, infrastructure method, geopolitical timing, or nation-state nexus
get_threat_pathGet full details of a specific threat path
map_frameworkGet framework-specific mappings (cfpf, mitre, groupib, ft3, ucff)
assess_coverageAssess fraud detection coverage by sector and fraud type
get_baselineGet fraud baseline measurements for benchmarking
look_left_rightAnalyze upstream/downstream threat relationships (CFPF Look Left/Right)

Example queries an AI assistant can answer via the MCP server:

  • "What fraud schemes target the insurance sector?"
  • "Which fraud types map across all 7 frameworks?"
  • "What MITRE ATT&CK techniques map to TP-0007?"
  • "Assess my coverage for banking account-takeover and wire-fraud"
  • "What threat paths feed into TP-0011?"
  • "Which threat paths involve RDGA infrastructure?"
  • "What is the UCFF maturity requirement for TP-0034?"

Running the MCP server

python -m mcp_server.server

Claude Desktop integration

Add the following to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "flame-fraud": {
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/path/to/flame-fraud"
    }
  }
}

CI/CD Pipeline

FLAME uses 7 GitHub Actions workflows for full automation:

WorkflowTriggerPurpose
build-and-deploy.ymlPush to mainRun tests, validate TPs, rebuild database, export all artifacts, deploy to Pages
validate-pr.ymlPull requestValidate changed submissions against schema and taxonomy
ai-intake.ymlIssue labeled submissionAI-generated threat path draft from URL via Claude
generate_threat_path.ymlTriggered by ai-intakeGenerate TP markdown from AI output
peer-review.ymlLabel changesRoute submissions: submitted → under-review → approved → published
fetch-regulatory.yml2x daily (6 AM + 6 PM UTC weekdays)Fetch alerts from 6 government regulatory sources
update-database.ymlOn demandForce database rebuild with latest regulatory data

Security scanning: The CI pipeline includes Bandit SAST (static application security testing), pip-audit (dependency vulnerability scanning), and Ruff (linting and code quality). These run on every PR and push to main.


Quick Start

Browse online

Visit the FLAME platform.

Run locally

git clone https://github.com/elchacal801/flame-fraud.git
cd flame-fraud
pip install -r requirements.txt
python scripts/build_database.py
python -m http.server 8000
# Open http://localhost:8000

Export all artifacts

python scripts/export_flame_stix.py    # STIX 2.1 bundle
python scripts/export_misp.py          # MISP galaxy & feed
python scripts/export_taxii.py         # TAXII 2.1 endpoints
# Sigma detection packs are now in flame-detections repo

Run the MCP server

python -m mcp_server.server

Subscribe via MISP

Point your MISP instance feed URL to database/misp-feed/manifest.json on the GitHub Pages site.

Subscribe via TAXII

Configure your TIP with the TAXII root at api/taxii/discovery.json on the GitHub Pages site.

Validate a submission

python scripts/validate_submission.py ThreatPaths/TP-0001-treasury-mgmt-ato-malvertising.md

Run tests

pytest tests/ -v

Contributing

FLAME is community-driven. Contributions of threat paths, detection rules, baselines, and emulation playbooks are welcome from practitioners across all financial sectors.

Three ways to contribute

  1. AI-Assisted Intake (recommended) -- Open an Issue with the Intel Submission template, paste a URL to a fraud advisory or report, and the AI pipeline generates a structured threat path draft for review.

  2. Web submission form -- Use the Contribute page with live preview and pre-filled GitHub Issue generation.

  3. Manual PR -- Fork the repo, copy the appropriate template from Templates/, fill in all sections, and submit a pull request.

Peer review workflow

Submissions follow a label-driven lifecycle: submitted → under-review → approved → published. All PRs are automatically validated against the schema and taxonomy. Contributors are tracked on the leaderboard.

See CONTRIBUTING.md for full guidelines, frontmatter requirements, and quality standards.


Testing

FLAME includes 251 tests across the full pipeline:

pytest tests/ -v

Test coverage includes: database build pipeline, STIX 2.1 export, MISP galaxy generation, TAXII 2.1 endpoint generation, MCP server tools, submission validation, emulation playbook validation, regulatory data fetching (6 sources), regulatory models and serialization, PDF parsing, RSS feed generation.


Operational Evidence

Threat paths can include an Operational Evidence section linking real-world investigation findings to the fraud lifecycle. Evidence entries follow the format EV-[TP-ID]-[YYYY]-[NNN] and are parsed into:

  • flame-content/TP-XXXX.json -- full evidence array per threat path
  • flame-index.json -- evidence_count per entry
  • flame-evidence-index.json -- cross-TP evidence listing for deduplication

Evidence is currently sourced from the domain_intel investigation pipeline.


Documentation


Related Projects

  • flame-detections -- Open-source fraud detection rule pack built on FLAME taxonomy. Detection rules are being decoupled from this repo for independent quality and contribution cadence.

Roadmap

  • MITRE F3 mapping -- Completed April 2026; full 91/91 coverage August 2026
  • Detection rule decoupling -- Completed May 2026: 221 rules in flame-detections
  • Threat path matrix view -- Completed May 2026: ATT&CK-style matrix with 11 fraud families, sector tabs, short-name chips
  • STIX SCO extensions -- Observable-level extensions for fraud indicators
  • Expanded emulation playbooks -- Coverage for remaining threat path categories
  • Community growth -- Industry partnerships and contributor onboarding

Credits

  • HEARTH / THOR Collective -- Architectural model and inspiration
  • FS-ISAC CFPF Working Group -- Primary fraud lifecycle framework
  • Group-IB -- Fraud Matrix 2.0 stage names and UCFF governance domains referenced for cross-taxonomy interoperability
  • Stripe -- FT3 (MIT-licensed) taxonomy structure
  • MITRE -- ATT&CK framework; F3 Fight Fraud Framework (shipped April 2026, mapped to 91/91 TPs)
  • FBI IC3 -- 2025 Internet Crime Report ($20.877B losses) enriching 17 TPs with updated statistics
  • OASIS -- STIX 2.1 and TAXII 2.1 specifications
  • Recorded Future -- Source intelligence for payment fraud threat paths (TP-0035 -- TP-0039)
  • LexisNexis Risk Solutions -- Global State of Fraud 2026 intelligence (TP-0040 and enhancements)
  • World Cybercrime Index -- Bruce et al. (2024) PLoS ONE geographic cybercrime attribution data (BL-0036 and geopolitical TP enrichments)

License

MIT License. See LICENSE.

↑↓ navigate openesc close