Skip to content

julianlaycock/aifmd-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

aifmd-toolkit

The open-source CLI for AIFMD II compliance.

npm version License: Apache-2.0 CI Node

Sanctions screening, LEI lookup, filing deadlines, NCA profiles, Annex IV validation — all from your terminal. Zero config. Powered by the Caelith API.

Part of the Caelith open-source ecosystem. Generate Annex IV XML with open-annex-iv, then validate it with aifmd-toolkit validate.


Quick Start

No install needed — just run:

npx aifmd-toolkit screen "Vladimir Putin"

Or install globally:

npm install -g aifmd-toolkit

Commands

screen <names...> — Sanctions Screening

Screen individuals or entities against global sanctions lists (EU, UN, OFAC, UK).

npx aifmd-toolkit screen "Vladimir Putin"
npx aifmd-toolkit screen "Acme Holdings Ltd"
  Sanctions Screening: Vladimir Putin

  Found 3 matches across EU, UN, and OFAC sanctions lists.
  ⚠ MATCH: Vladimir Vladimirovich Putin — EU Regulation 269/2014
  ⚠ MATCH: PUTIN, Vladimir — OFAC SDN List
  ⚠ MATCH: Putin, Vladimir V. — UN Security Council

  Powered by Caelith API — https://www.caelith.tech/api/docs

lei <code_or_name> — LEI Lookup

Look up Legal Entity Identifiers by LEI code or entity name.

npx aifmd-toolkit lei "BlackRock"
npx aifmd-toolkit lei 549300B56MD0ZC402L06
  LEI Lookup: BlackRock

  Entity:     BlackRock, Inc.
  LEI:        549300FHB56AYG2MXR64
  Status:     ISSUED
  Jurisdiction: US-DE
  Registered: 2012-06-06

  Powered by Caelith API — https://www.caelith.tech/api/docs

deadlines [--country <code>] — Filing Deadlines

Check when your next Annex IV filing is due. Optionally filter by country.

npx aifmd-toolkit deadlines
npx aifmd-toolkit deadlines --country LU
  Filing Deadlines (LU)

  Next Annex IV filing due: 2025-01-31
  Frequency: Semi-annual (for AIFMs managing >€1bn AuM)
  NCA: CSSF (Luxembourg)
  Portal: https://reporting.cssf.lu

  Powered by Caelith API — https://www.caelith.tech/api/docs

nca <code> — NCA Profile & Quirks

Get the profile and Annex IV reporting quirks for any National Competent Authority.

npx aifmd-toolkit nca DE
npx aifmd-toolkit nca LU
  NCA Profile: DE

  Authority:  BaFin (Bundesanstalt für Finanzdienstleistungsaufsicht)
  Country:    Germany
  Portal:     MVP Portal (https://mvp.bafin.de)

  Quirks:
  • Requires German-language field descriptions in certain templates
  • Strict LEI validation — rejects expired LEIs
  • Additional national reporting fields beyond standard Annex IV
  • Filing window opens 15 days before deadline

  Powered by Caelith API — https://www.caelith.tech/api/docs

validate <file.xml> — Validate Annex IV XML (Offline)

Validate your Annex IV XML file against ESMA structure rules — entirely offline, no API call needed.

npx aifmd-toolkit validate ./report.xml
  Annex IV Validation: ./report.xml

  ✔ All checks passed — no issues found

  Powered by Caelith API — https://www.caelith.tech/api/docs

With errors:

  Annex IV Validation: ./bad-report.xml

  ✖ Invalid PredominantAIFType: "ABCD" — expected one of: HFND, PEQF, REST, FOFS, VCAP, INFR, COMF, OTHR, NONE
  ✖ Invalid LEI length (15 chars): "549300B56MD0ZC4" — expected 20
  ⚠ LEI checksum invalid: "549300B56MD0ZC402L99" — verify manually
  ✖ Invalid ReportingMemberState: "XX" — expected valid EU/EEA country code

  3 error(s), 1 warning(s)

  Powered by Caelith API — https://www.caelith.tech/api/docs

Checks performed:

  • Required elements: <AIFReportingInfo>, <AIFRecordInfo>, <AIFCompleteDescription>
  • Valid PredominantAIFType values (HFND, PEQF, REST, FOFS, VCAP, INFR, COMF, OTHR, NONE)
  • LEI format (20 characters) and ISO 17442 checksum validation
  • ReportingMemberState is a valid EU/EEA country code

compare <nca1> <nca2> — Compare Two NCAs

Side-by-side comparison of reporting requirements between two National Competent Authorities.

npx aifmd-toolkit compare DE LU
npx aifmd-toolkit compare IE FR
  NCA Comparison: DE vs LU

  Both NCAs require standard ESMA Annex IV reporting, but differ in:

  | Aspect              | BaFin (DE)            | CSSF (LU)             |
  |---------------------|-----------------------|-----------------------|
  | Portal              | MVP Portal            | CSSF Reporting Portal |
  | Language            | German required       | English accepted      |
  | Extra fields        | Yes (national annex)  | Minimal               |
  | LEI strictness      | Rejects expired LEIs  | Warns only            |
  | Filing window       | 15 days before        | 30 days before        |

  Powered by Caelith API — https://www.caelith.tech/api/docs

How It Works

The validate command runs entirely offline — it reads your XML file and checks structure, codes, and LEI checksums locally.

All other commands (screen, lei, deadlines, nca, compare) query the Caelith Copilot API, an AI-powered compliance assistant. Responses are generated by the Caelith platform and should be treated as informational — always verify against authoritative sources for production compliance decisions.


Why This Tool?

AIFMD II is coming. The revised Alternative Investment Fund Managers Directive enters into force in 2026, bringing significant changes to Annex IV reporting, delegation rules, and liquidity management.

Fund managers, compliance teams, and service providers need fast access to:

  • Sanctions screening before onboarding investors
  • LEI lookups for regulatory filings
  • NCA-specific quirks that catch you off guard at deadline time
  • XML validation before submitting to your NCA portal
  • Deadline tracking across jurisdictions

aifmd-toolkit puts all of this in your terminal — free, open-source, zero config.


Related Projects

Project Description
open-annex-iv Zero-dependency TypeScript library for generating ESMA Annex IV XML
Caelith Full AIFMD II compliance platform — AI-powered filing, screening, and monitoring

Development

git clone https://github.com/julianlaycock/aifmd-toolkit.git
cd aifmd-toolkit
npm install
npm run build
npm test

Run locally without building:

npx ts-node src/cli.ts screen "Test Name"

License

Apache-2.0 — see LICENSE.

Built by Caelith.

About

Free CLI for AIFMD II compliance — sanctions screening, LEI validation, filing deadlines, NCA quirks, Annex IV XML validation

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors