singularityjason avatar

Lightning Memory

singularityjason/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 tools

Public 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

PyPI version Python 3.10+ License: MIT

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.


View the full README on GitHub

Details

Repository
github.com/singularityjason/lightning-memory
Category
AI & LLM Tools
Package
lightning-memory
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1riproductions avatarWingmanProtocol Agent Gatewayriproductions/wingman-agent-gatewayDurable memory, headless browser and research for agents. Pay per call: x402 USDC on Base or credits0stars
2hrrodan avatarAgent Workspace MCPhrrodan/agent-workspace-mcpA sandboxed, agentic workspace providing secure filesystem, bash, and uv-powered Python execution.1stars
3rishiatlan avatarClaude Prompt Optimizerrishiatlan/claude-prompt-optimizer-mcpScores, compiles & optimizes prompts for any LLM. Zero AI calls inside. Freemium.1stars
4rastogivaibhav avatarLlm Koshrastogivaibhav/llm-koshLocal-first AI memory cartridge with persistent MCP memory for Claude via SQLite FTS5.1stars
5agent-blueprint avatarFree Blueprintsagent-blueprint/free-blueprintsTwo sample multi-agent blueprints over MCP, no signup. Main server: agentblueprint.ai/mcp0stars
6davidmosiah avatarShort Video Agent Kitdavidmosiah/short-video-agent-kitProvider-neutral short-form AI video toolkit for agents: Sora, Gemini Veo, xAI/Grok, Seedance.0stars