
Lightning Memory
This server turns your AI agent into a Lightning-native spender with persistent memory and vendor intelligence. It stores transactions, preferences, and vendor interactions locally in SQLite with FTS5 search, syncs them as NIP-78 events to Nostr relays using BIP-340 keypairs, and exposes 22 MCP tools for querying payment history, checking vendor reputation scores, detecting price anomalies, and enforcing per-vendor budgets. The preflight gate blocks suspicious invoices before you pay them. You can run an L402 gateway so other agents pay sats to query your memory, and discover remote gateways to buy intelligence from the network. Reach for this if you're building autonomous agents that make L402 payments and need spending discipline, vendor trust signals, and cross-session learning without starting from zero every time.
- GitHub stars
- 7
- tools
- 22
- transport
- STDIO
- last updated
- Mar 4, 2026
Tools
22 toolsPublic tool metadata for what this MCP can expose to an agent.
memory_storeStore a memory (transaction, vendor, preference, error, decision)
Store a memory (transaction, vendor, preference, error, decision)
No parameter schema in public metadata yet.
memory_querySearch by relevance (FTS5 + optional semantic search)
Search by relevance (FTS5 + optional semantic search)
No parameter schema in public metadata yet.
memory_listList memories with type/time filters
List memories with type/time filters
No parameter schema in public metadata yet.
memory_editEdit content or metadata with audit trail
Edit content or metadata with audit trail
No parameter schema in public metadata yet.
memory_syncSync with Nostr relays (push/pull)
Sync with Nostr relays (push/pull)
No parameter schema in public metadata yet.
memory_exportExport as NIP-78 Nostr events
Export as NIP-78 Nostr events
No parameter schema in public metadata yet.
ln_vendor_reputationReputation score from transaction history
Reputation score from transaction history
No parameter schema in public metadata yet.
ln_spending_summarySpending breakdown by vendor and protocol
Spending breakdown by vendor and protocol
No parameter schema in public metadata yet.
ln_anomaly_checkDetect if a payment is abnormally high
Detect if a payment is abnormally high
No parameter schema in public metadata yet.
ln_preflightPre-flight gate: budget + anomaly + trust check before payment
Pre-flight gate: budget + anomaly + trust check before payment
No parameter schema in public metadata yet.
ln_budget_setSet per-vendor spending limits (per txn, per day, per month)
Set per-vendor spending limits (per txn, per day, per month)
No parameter schema in public metadata yet.
ln_budget_checkCheck spending against limits
Check spending against limits
No parameter schema in public metadata yet.
ln_budget_statusGateway earnings and L402 payment stats
Gateway earnings and L402 payment stats
No parameter schema in public metadata yet.
ln_vendor_trustFull trust profile (KYC + reputation + community score)
Full trust profile (KYC + reputation + community score)
No parameter schema in public metadata yet.
ln_trust_attestPublish NIP-85 trust attestation to Nostr relays
Publish NIP-85 trust attestation to Nostr relays
No parameter schema in public metadata yet.
ln_agent_attestStore a KYA (Know Your Agent) attestation
Store a KYA (Know Your Agent) attestation
No parameter schema in public metadata yet.
ln_agent_verifyLook up an agent's compliance status
Look up an agent's compliance status
No parameter schema in public metadata yet.
ln_auth_sessionStore LNURL-auth session records
Store LNURL-auth session records
No parameter schema in public metadata yet.
ln_auth_lookupLook up LNURL-auth sessions
Look up LNURL-auth sessions
No parameter schema in public metadata yet.
ln_compliance_reportGenerate structured compliance export
Generate structured compliance export
No parameter schema in public metadata yet.
ln_discover_gatewaysFind remote Lightning Memory gateways via Nostr
Find remote Lightning Memory gateways via Nostr
No parameter schema in public metadata yet.
ln_remote_queryQuery a remote gateway via L402 micropayment
Query a remote gateway via L402 micropayment
No parameter schema in public metadata yet.
Sponsors
Readme
Lightning Memory
Persistent memory for AI agents in the Lightning economy.
The Problem
AI agents spend sats over Lightning via L402 — but they can't remember what they bought. Every session starts from zero. Every vendor is a stranger. Every price is accepted at face value. An agent that paid 500 sats yesterday doesn't know if today's 5,000 sat invoice is a price spike or normal.
The Solution
L1: Bitcoin — settles
L2: Lightning — pays
L3: Lightning Memory — remembers
Lightning Memory gives agents persistent memory, vendor intelligence, and payment safety gates. Agents learn from their spending history, track vendor reputations, detect price anomalies, enforce budgets, and share trust signals with other agents.
Interactive Demo — watch an agent learn, get rugged, and route around bad actors.
Details
- Repository
- github.com/singularityjason/lightning-memory
- Category
- AI & LLM Tools
- Package
lightning-memory- Transport
- STDIO
- Registry
- MCP registry, active