andry-lebedev GitHub avatar

neobank-primitives

andry-lebedev

Neobank Primitives is an open-source, agent-native financial infrastructure that provides composable building blocks for accounts, identity, deposits, payouts, and policy-controlled operations, with a working demo and a Swipelux sandbox integration.

Stars

169

7-day growth

No data

Forks

1

Open issues

0

License

No data

Last updated

2026-07-14

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It introduces a provider-neutral abstraction layer designed for both fintech applications and AI agents, with a clear policy engine that makes autonomy configurable and safe, while offering a fully interactive demo that works without credentials.

Who it is for

  • Fintech developers building reusable financial primitives
  • AI agent developers needing safe, constrained financial tools
  • Startups exploring neobank or embedded finance products
  • Engineers evaluating policy-controlled financial APIs

Use cases

  • Quickly prototype a neobank with onboarding, KYC, balances, deposits, and transfers
  • Expose typed SDK and MCP tools for AI agents to execute financial operations with policy guardrails
  • Test provider-neutral integrations by swapping demo data for a live Swipelux sandbox
  • Fork the starter and customize branding for a new fintech product

Strengths

  • Fully interactive demo that works locally without any credentials or .env file
  • Provider-neutral design with a clear DataSource boundary, making future adapters easy
  • Explicit lifecycle (validate → evaluate → authorize → execute → normalize → audit) for safe agent interaction
  • Typed TypeScript primitives and a modular architecture that separates UI from domain logic

Considerations

  • Early build – the MCP server, standalone SDK, policy engine, and full KYB surface are not yet shipped
  • Demo data and addresses must not be used with real funds; not a production compliance or custody system
  • Users are responsible for provider onboarding, credentials, jurisdictional requirements, and operational controls

README quick start

Neobank Primitives

Agent-native financial primitives for fintechs and software that can act.

Build accounts, identity flows, deposits, payouts, wallet transfers, and compliance-aware operations on a provider-neutral contract. Start with the working neobank demo; extend it into policy-controlled MCP tools and a TypeScript SDK.

Run locally · Explore the primitives · See the architecture · Read the roadmap

Money movement should be composable

Most financial APIs expose endpoints. Autonomous software needs a safer abstraction: explicit intent, policy evaluation, normalized execution, durable state, and receipts it can reason about.

Neobank Primitives is building that layer for two consumers:

  • Fintech applications that want reusable identity, account, balance, and transaction building blocks.
  • AI agents that need narrowly scoped financial tools, machine-readable outcomes, and human approval when policy requires it.

The repository is useful now as a fully interactive neobank starter with realistic demo data and a Swipelux sandbox integration. The MCP server, standalone SDK, policy engine, and full KYB surface described below are the direction of the project and are not yet shipped as a production runtime.

The primitive surface

PrimitiveWorking product flowTarget MCP + SDK contract
IdentityCustomer onboarding and KYC stateCreate, retrieve, and monitor customer identity
BusinessesBusiness account personaCreate organizations and track KYB requirements
AccountsFiat accounts, stablecoin wallets, and balancesProvision and query normalized financial accounts
TransactionsQuotes, bank payouts, and wallet transfersQuote, authorize, execute, and inspect money movement
StorageLocal demo ledger and provider-backed statePersist normalized operation state, receipts, and metadata
ControlsHuman-readable execution explainersEvaluate policies, require approval, and expose audit history

The contract is designed to stay provider-neutral. Swipelux is the first adapter, not the shape every integration must inherit.

A

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191