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.

Building the Agent Economy — trust, budgets, compliance, and the memory marketplace.

Who Is This For

• Agents making L402 payments that need vendor reputation and spending discipline
• Developers building autonomous agents on Bitcoin/Lightning
• Anyone running an MCP-compatible AI agent (Claude, GPT, or any MCP client)

Quick Start

pip install lightning-memory
lightning-memory  # starts MCP server

Configure in Claude Code

{
  "mcpServers": {
    "lightning-memory": {
      "command": "lightning-memory"
    }
  }
}

Configure in Claude Desktop

{
  "mcpServers": {
    "lightning-memory": {
      "command": "python",
      "args": ["-m", "lightning_memory.server"]
    }
  }
}

How It Compares

Feature	Lightning Memory	Mem0	Raw file storage	No memory
Lightning/L402 awareness	Yes	No	No	No
Vendor reputation tracking	Yes	No	Manual	No
Spending anomaly detection	Yes	No	No	No
Nostr identity (BIP-340)	Yes	No	No	No
Relay sync (NIP-78)	Yes	No	No	No
Full-text + semantic search	Yes	Yes	No	No
Agent-to-agent knowledge markets	Yes (L402 gateway)	No	No	No
Budget enforcement	Yes	No	No	No
KYC/trust profiles	Yes	No	No	No
Payment pre-flight gate	Yes	No	No	No
Contradiction detection	Yes	No	No	No
Local-first / offline	Yes	Cloud	Yes	N/A
MCP native	Yes	Plugin	No	No
Zero config	Yes	API key required	Manual setup	N/A

Tools (22)

Memory

Tool	Description
memory_store	Store a memory (transaction, vendor, preference, error, decision)
memory_query	Search by relevance (FTS5 + optional semantic search)
memory_list	List memories with type/time filters
memory_edit	Edit content or metadata with audit trail
memory_sync	Sync with Nostr relays (push/pull)
memory_export	Export as NIP-78 Nostr events

memory_store(
  content="Paid 500 sats to bitrefill.com for a $5 Amazon gift card via L402.",
  type="transaction",
  metadata='{"vendor": "bitrefill.com", "amount_sats": 500}'
)

memory_query(query="bitrefill payment history", limit=5)
# → recency-weighted results with dedup and contradiction alerts

Lightning Intelligence

Tool	Description
ln_vendor_reputation	Reputation score from transaction history
ln_spending_summary	Spending breakdown by vendor and protocol
ln_anomaly_check	Detect if a payment is abnormally high

ln_vendor_reputation(vendor="bitrefill.com")
# → {re

... [View full README on GitHub](https://github.com/singularityjason/lightning-memory#readme)